Files
local-ci-cd-system/docs/Setup-GiteaSSH.md
T
Simone 90a4396443 feat: enhance documentation and scripts for in-VM Git cloning and template setup
- Updated README.md to reflect the new in-VM git clone feature with `-UseGitClone`.
- Modified Setup-Host.ps1 to correct VMX path references.
- Revised various documentation files (ARCHITECTURE.md, CI-FLOW.md, HOST-SETUP.md, WINDOWS-TEMPLATE-SETUP.md) to include updated paths and features.
- Added Setup-GiteaSSH.md for SSH configuration instructions.
- Archived outdated documentation and updated README.md for clarity on current resources.
2026-05-10 23:03:56 +02:00

2.4 KiB

Configurazione accesso SSH a Gitea

Target: clone da git@gitea.emulab.it:Simone/nsis-plugin-nsinnounp.git
Gitea: http://10.10.20.11:3100 / https://gitea.emulab.it


1. Genera la chiave SSH sull'host Windows

# Da PowerShell normale (non admin necessario)
ssh-keygen -t ed25519 -C "ci-build@WS1-W11" -f "$env:USERPROFILE\.ssh\id_ci_gitea"
  • Passphrase: lascia vuota (il CI gira non-interattivo)
  • Produce due file:
    • ~\.ssh\id_ci_gitea — chiave privata (non condividere mai)
    • ~\.ssh\id_ci_gitea.pub — chiave pubblica da aggiungere a Gitea

2. Aggiungi la chiave pubblica a Gitea

  1. Apri http://10.10.20.11:3100 → Login come Simone
  2. Menu utente (in alto a destra) → SettingsSSH / GPG Keys
  3. Clicca Add Key
  4. Incolla il contenuto di ~\.ssh\id_ci_gitea.pub:
Get-Content "$env:USERPROFILE\.ssh\id_ci_gitea.pub" | clip
  1. Key Name: WS1-CI-Host
  2. Salva → Add Key

3. Configura SSH client sull'host

Attenzione: 10.10.20.11 è già usato nel file ~\.ssh\config con User root (entry HomeAssistant). Non usare Host 10.10.20.11 direttamente — usare un alias dedicato gitea-ci.

Aggiungi in fondo a ~\.ssh\config:

$entry = @"

Host gitea-ci
    HostName 10.10.20.11
    Port 2222
    User git
    IdentityFile $env:USERPROFILE\.ssh\id_ci_gitea
    IdentitiesOnly yes
"@
Add-Content "$env:USERPROFILE\.ssh\config" $entry

4. Verifica connessione

ssh -T gitea-ci

Risposta attesa:

Hi there, Simone! You've successfully authenticated with the key named ci-build@WS1-W11, but Gitea does not provide shell access.

Nota: exit code 1 è normale — Gitea non fornisce shell, ma l'autenticazione è avvenuta.


5. Trova la porta SSH di Gitea

Porta confermata: 2222 (verificata con Test-NetConnection -ComputerName 10.10.20.11 -Port 2222).


6. URL SSH da usare in Invoke-CIJob.ps1

Usare l'alias gitea-ci definito in ~\.ssh\config:

-RepoUrl 'ssh://gitea-ci/Simone/nsis-plugin-nsinnounp.git'

Oppure con IP/porta espliciti (equivalente):

-RepoUrl 'ssh://git@10.10.20.11:2222/Simone/nsis-plugin-nsinnounp.git'

7. Aggiungi host a known_hosts (evita prompt interattivo)

ssh-keyscan -p 2222 10.10.20.11 >> "$env:USERPROFILE\.ssh\known_hosts"