KB Flooris Ploi - Nieuwe site aanmaken¶

Procedure voor het aanmaken van een nieuwe site op een bestaande Ploi-managed server.

Nog geen server aanwezig?

Moet er eerst nog een nieuwe server uitgerold worden? Volg dan eerst KB Flooris Ploi - Nieuwe server uitrollen voordat je onderstaande procedure doorloopt.

Checklist¶

Ploi site aanmaken¶

Ga naar de betreffende server in Ploi en klik op Sites → New site
Vul de domeinnaam van de site in
Kies het juiste Project Type

Kies altijd voor Advanced settings

Kies bij het aanmaken van een nieuwe site altijd voor Advanced settings, ook als de standaardwaarden lijken te volstaan. Alleen via de advanced settings kun je de juiste systeemgebruiker selecteren of aanmaken — zie de volgende stap.

Rond de site af met Add site

Systeemgebruiker instellen¶

Elke site draait onder een systeemgebruiker (system user) op de server.

Systeemgebruiker is altijd klantspecifiek — géén willekeurige naam

Laat Ploi nooit automatisch een willekeurige gebruikersnaam genereren. De systeemgebruiker moet altijd herleidbaar zijn naar de klant of het project, bijv. hetid of trampolineingraven.

Controleer bij de Advanced settings of er op deze server al een systeemgebruiker bestaat voor deze klant
Bestaat deze nog niet? Maak dan een nieuwe systeemgebruiker aan met een klantspecifieke naam (lowercase, geen spaties of leestekens) — pas de voorgestelde naam handmatig aan indien nodig
Bestaat de systeemgebruiker al, bijvoorbeeld omdat er al een andere deployment van dezelfde klant op deze server draait? Selecteer dan die bestaande gebruiker, zodat alle deployments van de klant onder dezelfde systeemgebruiker draaien

Docker permission denied bij het build proces?

Een nieuwe systeemgebruiker zit niet automatisch in de docker group. Dit is alleen relevant als het project Docker gebruikt (bijv. de front-end builder in het deployment script) — voor de meeste sites is dit niet nodig.

Het beste is om dit niet preventief te doen, maar pas als het build proces daadwerkelijk mislukt met een permission denied fout op de Docker socket. Volg dan de procedure in KB Flooris Ploi - Docker permission denied om de systeemgebruiker aan de docker group toe te voegen.

Airtable — site registreren¶

Naast het aanmaken van de site in Ploi moet de site ook toegevoegd of bijgewerkt worden in de Flooris Hosting Airtable.

Ga naar de Flooris Hosting tabel in Airtable
Maak een nieuw record aan voor de site, of werk het bestaande record bij
Vul in ieder geval de volgende velden in:
- Domeinnaam
- Server (koppeling naar het serverrecord)
- Systeemgebruiker
- Ploi site ID

Server nog niet geregistreerd?

Staat de server zelf nog niet in Airtable? Volg dan eerst de stap Airtable — server registreren uit de procedure voor het uitrollen van een nieuwe server.

Git repository installeren¶

Ga in Ploi naar de site → Git
Koppel de juiste Git repository en branch
Klik op Install repository

Ploi Script toepassen (optioneel)¶

Bij het installeren van de Git repository kan je optioneel ook een Ploi Script selecteren als basis voor het deployment script.

Laravel deploy script with Infisical .env and Docker front-end builder

Voor Laravel projecten is er een herbruikbaar Ploi Script beschikbaar met de naam "Laravel deploy script with Infisical .env and Docker front-end builder".

Dit script is een template: bij het toepassen ervan krijgt de site een kopie van het script als deployment script. Je mag en kan deze kopie daarna vrij aanpassen aan de specifieke situatie van het project (bijv. paden, branch, build commando's) — dit is helemaal prima.

Zie ook KB Flooris Ploi - Infisical env file voor meer achtergrond over het ophalen van de environment file via Infisical.

SSL certificaat aanvragen¶

Voor SSL via LetsEncrypt gebruiken we een DNS challenge met een Cloudflare API token.

Volg hiervoor de volledige instructies in:

KB Flooris Ploi - Cloudflare API token voor SSL (LetsEncrypt DNS challenge)