Deployment con Docker Compose

Il servizio Apps consente di effettuare il deployment di un'applicazione utilizzando un file docker-compose.yml presente nel repository. Questo permette di eseguire qualsiasi tipo di applicazione, incluse quelle sviluppate con framework frontend e backend non direttamente supportati dal servizio.

Requisiti

• Posiziona il file docker-compose.yml nella directory principale del repository.

• Non usare le porte 80 e 443 come porte host nel manifesto. Queste porte sono riservate a Nginx.

• Il proxy viene configurato per il primo servizio elencato in docker-compose.yml. Gli altri servizi, se hanno porte host definite, saranno accessibili solo tramite quelle porte esplicite. Ad esempio:

 

services:
  my-app:
    ports:
      - "9000:80"
  adminer:
    ports:
      - "8080:8080"

 

In questo caso:

• • my-app sarà disponibile sul dominio principale.
  • adminer sarà disponibile all’indirizzo http://<dominio>:8080.

I volumi creati nel file docker-compose.yml non verranno mantenuti tra un deployment e l’altro.

Passaggio 1. Seleziona il Tipo di Applicazione

1. Vai alla sezione App Platform e clicca su Crea.
2. Seleziona la scheda Docker Compose.

Passaggio 2. Collega un Repository

Seleziona il repository contenente l'applicazione. Il file docker-compose.yml deve trovarsi nella directory principale del repository.

Puoi collegare un repository:

• Dal tuo account GitHub, GitLab o Bitbucket. Clicca sul nome della piattaforma, accedi e seleziona il repository desiderato. Se sei già loggato, Hostman mostrerà automaticamente i repository disponibili.

• Tramite URL, fornendo un link a un repository su qualsiasi piattaforma. Clicca su "Collega il repository tramite URL" e inserisci l’URL Git. Se il repository è privato, inserisci anche le credenziali di accesso.

Leggi di più su come collegare repository qui.

Passaggio 3. Seleziona un Branch e un Commit

Seleziona il branch da usare per il deployment.

Per impostazione predefinita, è abilitata l'opzione "Build con l’ultimo commit eseguito". In questo modo, la piattaforma eseguirà il deployment dell’ultimo commit e ricostruirà automaticamente l’applicazione ogni volta che viene aggiunto un nuovo commit. Se necessario, puoi disattivare il deployment automatico.

Se preferisci selezionare manualmente un commit specifico, disattiva questa opzione.

Passaggio 4. Seleziona la Posizione e la Configurazione del Server

L'applicazione verrà eseguita su un server cloud dedicato. Seleziona la regione e la configurazione del server.

Potrai sempre effettuare un upgrade del server in futuro, ma non sarà possibile effettuare un downgrade.

Passaggio 5. Configura la Rete Privata

Ora puoi aggiungere l’applicazione a una rete privata e specificare l’indirizzo IP da utilizzare.

Tieni presente che non sarà possibile modificare la rete privata dopo il deployment.

Step 6. Configure the Build Settings

La piattaforma leggerà le istruzioni dal file docker-compose.yml e costruirà l’applicazione di conseguenza.

A questo punto puoi definire variabili, se necessario. Se sono già indicate nel file docker-compose.yml o nel Dockerfile, non è necessario duplicarle. Le variabili verranno utilizzate nella fase di build del Dockerfile, ma attualmente non possono essere passate direttamente a docker-compose.yml.

In seguito potrai modificare queste impostazioni, scegliere un altro branch o commit e riavviare il deployment con i nuovi parametri.

Passaggio 7. Inserisci le Informazioni dell'App

Qui puoi specificare un nome e un commento per la tua applicazione, che verranno visualizzati nel pannello di controllo di Hostman. Puoi anche selezionare un progetto a cui aggiungere l'app.

Queste impostazioni possono essere modificate anche in un secondo momento.

Passaggio 8. Deployment

Clicca su Avvia Deploy. Una volta avviato il processo, vedrai i log del deployment nella scheda Deploy.

Il log del deployment contiene tutte le informazioni necessarie per risolvere eventuali problemi. Se qualcosa va storto — ad esempio a causa di un errore nel codice — il log mostrerà una notifica con la causa specifica del problema.

Durante il primo deployment di un progetto, l’installazione del server può richiedere qualche minuto. Al termine del processo, lo stato dell’app verrà aggiornato e verrà visualizzato un messaggio nel log.

Tutto fatto!

Puoi trovare l’indirizzo IP dell’applicazione e il dominio tecnico collegato nella scheda Dashboard. Per collegare un tuo dominio personalizzato, segui questa guida.

L’applicazione funziona sulle porte 80 e 443.

In futuro, la piattaforma delle app monitorerà il repository e, se il deployment automatico è abilitato, ricostruirà automaticamente il progetto ogni volta che vengono apportate modifiche.