Distribuire con Dockerfile

Utilizzando un Dockerfile puoi distribuire qualsiasi applicazione sulla Piattaforma App, a prescindere dal framework con cui è stata creata.

Requisiti

• Per eseguire il deploy senza problemi, il Dockerfile deve trovarsi nella directory principale del repository. Deve contenere tutte le istruzioni necessarie per costruire ed eseguire l'applicazione.

• È necessario specificare il parametro EXPOSE nel Dockerfile affinché Hostman possa determinare su quale porta deve ascoltare Nginx. Se EXPOSE non è impostato, per impostazione predefinita Nginx userà la porta 8080 del container.

Esempio:

FROM python:3.6
MAINTAINER Name Name "mail@mail.com"
COPY . /app
WORKDIR /app
RUN pip install -r requirements.txt
ENTRYPOINT ["python"]
CMD ["app.py"]
EXPOSE 3478

• Puoi impostare le variabili d’ambiente nel Dockerfile oppure direttamente nel pannello di controllo Hostman durante la creazione di una nuova app.

Passaggio 1. Seleziona il tipo di applicazione

1. Vai nella sezione Piattaforma App e fai clic su Crea.

2. Seleziona la scheda Dockerfile.

Passaggio 2. Collega un Repository

Seleziona il repository che contiene l’applicazione. Il Dockerfile deve essere posizionato nella directory principale.

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 creato su qualsiasi piattaforma. Clicca su Connetti repository via URL e inserisci l’URL Git. Se il repository è privato, inserisci anche le credenziali di accesso.

Scopri di più su come collegare i repository qui.

Passaggio 3. Seleziona un Branch e un Commit

Seleziona il branch da utilizzare per il deploy.

Per impostazione predefinita è attiva l’opzione “Build con l’ultimo commit eseguito”. In questo caso, la piattaforma distribuirà l’ultimo commit e aggiornerà automaticamente l’applicazione con ogni nuovo commit. Se necessario, puoi disattivare il deploy automatico.

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

Passaggio 4. Seleziona la Posizione e la Configurazione del Server

L'app deve essere eseguita su un server cloud dedicato. Seleziona la regione e la configurazione del server.

Potrai aggiornare il server in qualsiasi momento, 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 deploy.

Passaggio 6. Configura le impostazioni di build

La Piattaforma App leggerà i parametri definiti nel Dockerfile e compilerà l'app di conseguenza.

In questa fase puoi impostare variabili, se necessario. Se sono già presenti nel Dockerfile, non serve duplicarle.

Successivamente potrai modificare queste impostazioni, cambiare branch o commit e rilanciare il deploy con i nuovi parametri.

Passaggio 7. Inserisci le Informazioni sull’App

Qui puoi specificare un nome e un commento per la tua app, che saranno visibili nel pannello di controllo Hostman. Puoi anche assegnare l'app a un progetto.

Queste impostazioni possono essere modificate in seguito.

Passaggio 8. Avvia il Deploy

Fai clic su Avvia Deploy. Una volta avviato il processo, vedrai il log nella scheda Deploy.

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

Al primo deploy, l’installazione del server potrebbe richiedere un po’ di tempo. Una volta completata, lo stato dell'app verrà aggiornato e vedrai un messaggio nel log.

Tutto fatto!

Trovi l’indirizzo IP dell’app e il dominio tecnico collegato nella scheda Dashboard. Per collegare il tuo dominio personale, segui questa guida.

L'applicazione funziona sulle porte 80 e 443.

In futuro, la piattaforma app monitorerà il repository e, se il deploy automatico è attivo, ricostruirà automaticamente l'app ogni volta che rileva modifiche.