Come Connettere i Repository

Puoi collegare il repository con il codice della tua applicazione alla nostra App Platform durante la creazione di una nuova app nel pannello di controllo di Hostman.

La App Platform supporta repository GitLab, GitHub e BitBucket, così come repository accessibili tramite URL, inclusi Gitea, GitLab self-hosted, GitHub Enterprise, ecc.

Collegare un repository da GitLab, GitHub o BitBucket

Per collegare il repository:

1. Vai alla sezione App Platform e clicca su Crea.

2. Nel passaggio Repository, clicca sull'icona della piattaforma.

3. Accedi al tuo account.

4. Autorizza l’accesso ai repository richiesti.

5. Seleziona il repository da utilizzare per il deployment nella dashboard di Hostman.

Se hai già effettuato l'accesso a GitHub, GitLab o Bitbucket, Hostman mostrerà automaticamente i repository disponibili. Devi solo selezionare quello necessario.

Se sei già connesso ma il repository desiderato non appare:

1. Clicca su Aggiungi account.

2. Scegli una piattaforma.

3. Accedi se richiesto.

4. Seleziona i repository da autorizzare e salva le modifiche.

Quindi seleziona il repository desiderato per il deployment nella dashboard di Hostman.

Collegare un repository tramite URL

Puoi collegare qualsiasi repository che abbia un indirizzo HTTP o HTTPS, inclusi quelli su GitLab self-hosted, GitHub Enterprise o fornitori che non supportiamo direttamente (es. Gitea).

Questa opzione è utile anche per motivi di sicurezza: se non vuoi autorizzare l’intero account Git, puoi aggiungere solo un repository specifico tramite link.

Nota: il deployment automatico non è disponibile per i repository collegati tramite URL. Dopo aver aggiornato il codice, dovrai avviare manualmente il deployment selezionando il commit.

Per repository pubblici, è sufficiente fornire l’URL.

Per repository privati, devi fornire login e password oppure un token generato dal provider (GitLab, GitHub, ecc.).

Collegare un repository

Puoi collegare un repository tramite URL durante la creazione di una nuova applicazione:

1. Vai alla sezione App Platform e clicca su Crea.

2. Nel passaggio Repository, clicca su Collega repository tramite URL.

3. Inserisci l’URL del repository e i dati di accesso se il repository è privato.

4. Clicca su Collega.

Il repository e i commit disponibili verranno visualizzati nel pannello di controllo.

Ottenere un link git

Il link deve essere nel formato URL Git, ad esempio:

https://github.com/hostman/app-example.git

In GitHub, clicca su Codice → HTTPS per ottenere il link.

In GitLab o BitBucket: vai al repository → clicca su Codice/Clona → Clona con HTTPS.

Ottenere link e token su BitBucket

Ci sono due modi per ottenere un token e un link su BitBucket.

Metodo 1.

1. Vai su Impostazioni personali di Bitbucket → Password app.

2. Imposta un nome (Etichetta) e autorizzazioni; sono sufficienti le autorizzazioni di sola lettura.

3. Clicca su Crea.

4. Copia la password e incollala nel campo Password o token della dashboard Hostman.

5. Vai al repository e clicca su Clona. Copia tutto ciò che segue git clone e incollalo nel campo URL del repository.

6. Copia la parte del link tra https:// e @ e incollala nel campo Nome utente.

Metodo 2.

1. Vai su Impostazioni → Impostazioni del repository → Token di accesso → Crea token di accesso al repository.

2. Imposta nome e autorizzazioni (Ambiti). È sufficiente l’accesso in sola lettura.

3. Copia il valore dal campo Il tuo token di accesso al repository e incollalo nel campo Password o token nella dashboard di Hostman.

4. Come link del repository, utilizza l’URL dal campo Come usare questo token con il tuo repository Git. Copia tutto ciò che segue git clone e incollalo nel campo URL nella dashboard di Hostman.

Ottenere un token su GitHub

Non puoi collegare un repository GitHub con la sola password; è necessario un token.

Per generare un token in GitHub:

1. Vai su Impostazioni → Impostazioni sviluppatore → Token di accesso personale → Token → Genera token personale.

2. Imposta nome, data di scadenza e autorizzazioni. Per lavorare con repository privati, seleziona repo.

3. Clicca su Genera token.

4. Copia il token e incollalo nel campo Password o token nella dashboard di Hostman.

Ottenere un token su GitLab

Per collegare repository GitLab, puoi usare la password del tuo account o un token generato dalle impostazioni del tuo profilo GitLab.

1. Vai su Preferenze → Token di accesso.

2. Crea un nuovo token specificando nome, scadenza e autorizzazioni. Almeno, devi autorizzare l’accesso in lettura ai repository.

3. Clicca su Crea token personale.

4. Copia il token e incollalo nel campo Password o token della dashboard di Hostman.

Rimuovere repository collegati

Qualsiasi repository aggiunto può essere scollegato dalla App Platform.

Se scolleghi un repository, i deployment (sia automatici che manuali) di tutte le applicazioni create da quel repository non saranno più possibili.

1. Vai alla sezione App Platform e clicca su Crea.

2. Vai al passaggio Repository. Clicca sul menu a discesa dei repository e clicca su Elimina accanto a quello che vuoi rimuovere.

3. Conferma l’azione.

Il repository non appare nella App Platform

Se il tuo account GitHub, GitLab o Bitbucket è connesso alla App Platform ma il repository richiesto non viene visualizzato nella dashboard Hostman, potrebbero esserci due motivi:

• Hai aggiunto il repository dopo aver effettuato l’accesso alla piattaforma.

• Hai autorizzato l’accesso solo ad alcuni repository, e quello necessario non è stato selezionato.

Per risolvere il problema:

1. Vai alla sezione App Platform e clicca su Crea.

2. Vai al passaggio Repository e clicca su Aggiungi account.

3. Scegli una piattaforma.

4. Accedi se necessario.

5. Seleziona il repository desiderato e salva le modifiche.

I repository collegati appariranno nella dashboard di Hostman e potrai selezionare quello che ti serve.