Instructies

My Combell: Reseller account aanmaken

open https://my.combell.com/
ga naar reseller -> Accounts
klik bovenaan op '+ Toevoegen'
vul nodige gegevens in, laatste 2 dropdowns zijn niet nodig Geef altijd de naam (accountnaam)van het hoofddomain in. bv. kaneka.be
Voeg je SSH key in om te kunnen deployen: joery.lemmens@DESKTOP-JVK115R
Kopieer het SSH wachtwoord voor de zekerheid, maak het project/de login aan op projects.brandle.be
Ga naar reseller, open de gewenste account
Ga naar databases, maak database(s) aan. Sla database wachtwoord op op projects.brandle.be
Indien nodig, importeer meteen geexporteerde database in de nieuwe database
Ga naar 'FTP & SSH' en activeer SSH toegang
Schakel SSH toegang in, voeg gegevens toe aan projects.brandle.be
ga naar 'PHP instellingen' en zet de memory_limit op maximum
voor productie moet /www verwijzen naar de /current/web folder. Maar dat gebeurt automatisch bij deployments met deployer. Nevertheless, hier is een voorbeeldje hoe je bv manueel via SSH de /www folder kan verwijzen naar /production/web:

#remove default www
rm -rf /data/sites/web/ka-posorderingtoolcom/www
# create production/web folder
cd /data/sites/web/ka-posorderingtoolcom
mkdir production
cd production
mkdir web
# create soft symlink www
ln -s /data/sites/web/ka-posorderingtoolcom/production/web /data/sites/web/ka-posorderingtoolcom/www

Ga in Combell naar het project en open File Manager en maak de nodige settings.db.php file aan met de juiste db gegevens (bv: shared/web/sites/default/settings.db.php):

<?php

$databases['default']['default'] = [
   'database' => 'ID73339_filepoint',
   'username' => 'ID73339_filepoint',
   'password' => '2W95Nf908NNBo9Dm3Ip4',
   'host' => 'ID73339_filepoint.db.webhosting.be',
   'driver' => 'mysql',
];

indien nodig, ga naar 'Domeinnamen & SSL' en klik op 'Website toevoegen' om de gewenste subdomeinen / staging/dev aan te maken, bv dev.maxusmotors.ch (enkel mogelijk indien wij DNS-registrar toegang hebben) anders bv. aswitch-dev.brandle.be

Ga naar Domeinnamen & SSL en voor de subsites klik op Beheer website -> Wijzig server map om deze te laten verwijzen naar de 'web' folder

GitLab: deployment naar Combell instellen

Open het project in GitLab
Ga naar Settings -> CI/CD
klik op 'Expand' bij Variables
voeg alle nodige variables toe voor deployment (Meestal: DEPLOY_HOST, DEPLOY_USER, POPUP_LOGIN en POPUP_PASSWORD). Vink aan: Protect variable en Expand variable reference
Ga naar Settings -> Repository -> Protected branches. Maak elke branch waarnaar je wil deployen (production, development) protected. Zet Allowed to merge en Allowed to push and merge op Developers + Maintainers
Bewerk project, bv in Visual Studio Code. In de gewenste branch.
Bewerk .gitlab-ci.yml om deployments naar combell in te stellen. Bv: https://gitlab.com/brandle/maxus-ch/-/blob/develop/.gitlab-ci.yml

GitLab: notificaties in Teams instellen

open project in GitLab
Ga naar Settings - Integrations
Microsoft Teams Integration -> configure
Webhook: https://groepdaneels.webhook.office.com/webhookb2/0ec78bde-ee43-4ec5-a354-fd4c0f2d8a17@e975c18d-6e2d-4445-bb4e-3302d85ab16b/IncomingWebhook/5a3433035f9942d89dd1cc09bdff6de2/b8eb83e6-1454-4389-a71c-a47da65f0cf0
Alles aangevinkt, maar vooral 'Notify only broken pipelines'

DNS-instellingen

Klanten hosten ofwel zelf hun domain(-s) beheren, mailboxen of wij hosten deze voor hen. Voor overzetten van sites van Nucleus naar Combell, check je ook eerst of de domains bij ons zitten, indien niet dien je de klant hiervan te verwittigen en de nodige gegevens te bezorgen en stappen uit te leggen. Ook belangrijk: ALTIJD checken of er mailboxen staan op de hosting, die dienen dan ook overgezet te worden, gebackuped indien nodig, hangt af van type mailaccount, -server.

IP-adressen hosting

Indien de domains worden beheerd bij de domainregistrar van de klant, dienen deze gegevens bezorgd te worden aan de klant. Via nslookup [DOMAIN] of https://whois.domaintools.com/ kan je eenvoudig checken waar die staan.

SSL-certificaten

Belangrijk ook vragen aan klant indien bestaande website vragen of ze zelf certificaten beheren (dan dien je deze door te geven aan Combell = tekstbestandjes met keys etc) ,indien niet, kan gewoon Let's encrypt (free). Indien domain niet bij ons, dient de klant voor www en non-www domain de certificaten te koppelen aan de IP-adresssen van de hosting. Indien bij ons, kunnen we dit zelf doen in Combell via de A-records.