Deployen met Docker Compose

Met de Apps-service kun je een applicatie deployen met behulp van een docker-compose.yml-bestand dat zich in de repository bevindt. Hiermee kun je elk type applicatie draaien, ook die gebouwd zijn met frontend- en backendframeworks die niet direct door de service worden ondersteund.

Vereisten

• Plaats het bestand docker-compose.yml in de hoofdmap van de repository.

• Gebruik poorten 80 en 443 niet als hostpoorten in het manifest. Deze poorten zijn gereserveerd voor Nginx.

• Proxyconfiguratie wordt toegepast op de eerste service in docker-compose.yml. Andere services met gedefinieerde hostpoorten zijn alleen via die specifieke poorten bereikbaar. Bijvoorbeeld:

 

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

 

In dit geval:

• • my-app is beschikbaar op het hoofddomein.
  • adminer is beschikbaar op http://<domein>:8080.

Volumes die in docker-compose.yml worden gedefinieerd, blijven niet behouden tussen deploys.

Stap 1. Selecteer het Type Applicatie

1. Ga naar het gedeelte App-platform en klik op "Aanmaken".
2. Selecteer het tabblad Docker Compose.

Stap 2. Verbind een Repository

Selecteer de repository waarin de applicatie zich bevindt. Het docker-compose.yml-bestand moet in de hoofdmap van de repository staan.

Je kunt een repository verbinden:

• Via je GitHub-, GitLab- of Bitbucket-account. Klik op de naam van het platform, log in en selecteer de gewenste repository. Als je al bent ingelogd, toont Hostman direct de beschikbare repositories.

• Via een URL, door een link op te geven naar een repository op een ander platform. Klik op "Repository via URL verbinden" en voer de Git-URL in. Als de repository privé is, vul dan ook de toegangsgegevens in.

Lees hier meer over het verbinden van repositories.

Stap 3. Selecteer een Branch en Commit

Selecteer een branch voor de deployment.

Standaard is de optie "Build met laatst uitgevoerde commit" ingeschakeld. In dit geval wordt de laatste commit gedeployed en zal de App-platform de applicatie automatisch opnieuw bouwen zodra er nieuwe commits worden toegevoegd. Je kunt automatische deployment uitschakelen indien nodig.

Als je handmatig een specifieke commit wilt kiezen, schakel dan deze optie uit.

Stap 4. Selecteer Serverlocatie en Configuratie

Je applicatie wordt uitgevoerd op een aparte cloudserver. Selecteer de regio en de gewenste configuratie van de server.

Je kunt de server later upgraden, maar downgraden is niet mogelijk.

Stap 5. Configureer een Privénetwerk

Je kunt de applicatie nu toevoegen aan een privénetwerk en het IP-adres opgeven dat de app zal gebruiken.

Let op: het privénetwerk kan na deployment niet meer worden gewijzigd.

Stap 6. Configureer de Build-Instellingen

Het App-platform leest de instructies uit docker-compose.yml en bouwt de applicatie dienovereenkomstig.

Je kunt hier variabelen instellen indien nodig. Als ze al zijn opgegeven in docker-compose.yml of het Dockerfile, hoef je ze niet te dupliceren. De variabelen worden gebruikt tijdens de buildfase van het Dockerfile, maar kunnen momenteel niet worden doorgegeven aan docker-compose.yml.

Later kun je deze instellingen wijzigen, een andere branch of commit selecteren en de deployment opnieuw uitvoeren met de nieuwe parameters.

Stap 7. Voer app-Informatie in

Je kunt hier een naam en een opmerking invoeren die worden weergegeven in het Hostman-dashboard. Je kunt de app ook toevoegen aan een project.

Deze instellingen kunnen later worden aangepast.

Stap 8. Deploy

Klik op "Start Deploy". Zodra het proces begint, zie je de deploylog in het tabblad Deploy.

De deploylog bevat alle benodigde informatie om eventuele problemen op te lossen. Als er iets misgaat — bijvoorbeeld door fouten in de code — zie je een melding met de oorzaak van het probleem.

Bij het eerste deployment van een project kan de installatie van de server even duren. Zodra het is voltooid, wordt de status van de app bijgewerkt en zie je ook een melding in de log.

Alles klaar!

Je vindt het IP-adres van de applicatie en het technische domein in het tabblad Dashboard. Volg deze gids om je eigen domein te koppelen aan de app.

De applicatie draait op poorten 80 en 443.

In de toekomst zal het App-platform wijzigingen in de repository blijven volgen en — als automatische deployment is ingeschakeld — het project automatisch herbouwen bij updates.