Handmatig Laravel in Docker

Docker is een manier om te applicatie te draaien door middel van containers. Voor school is het de opdracht om hiermee aan de slag te gaan. Hoe docker geïnstalleerd en gebruikt wordt is na te kijken op de onderstaande link. Dit is een pagina van mijn bedrijf waarmee ik instructies maak voor informatica.

AMP Stack met Docker

Laravel Installeren (Opdracht 1)

Om laravel te installeren op deze installatie moeten we een aantal dingen doen. We gebruiken dezelfde werkwijze als MySQL om Composer en Node te installeren. Daarnaast moet er een wijziging worden aangebracht in de dockerfile. De website van Laravel begint in de public map, hier moeten we naar verwijzen. Hiervoor hebben we de volgende code nodig:

# Set document root to public folder
ENV APACHE_DOCUMENT_ROOT=/var/www/html/public 

# Replace the default apache root with ours
RUN sed -ri -e 's!/var/www/html!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/sites-available/*.conf 
RUN sed -ri -e 's!/var/www/!${APACHE_DOCUMENT_ROOT}!g' /etc/apache2/apache2.conf /etc/apache2/conf-available/*.conf

# Enable rewrite mod, this is required for Laravel to work
# Rewrite mod allows the app to change the way the server handles urls
RUN sed -i '/<Directory \/var\/www\/>/,/<\/Directory>/ s/AllowOverride None/AllowOverride All/' /etc/apache2/apache2.conf 
RUN a2enmod rewrite

# Set the working directory to the root of the website
WORKDIR /var/www/html/

Vanaf dit punt kunnen we de console gebruiken om laravel te installeren. We hebben de package managers ingesteld om automatisch alles voor ons te installeren. Dit hebben we gedaan door hun composerfiles respectievelijk te wijzigen naar:

# dockerfile.composer
FROM composer:latest
WORKDIR /var/app/
CMD [ "composer", "install" ]

# dockerfile.node
FROM node:20-alpine
WORKDIR /var/app/
RUN [ "npm", "install" ]
ENTRYPOINT npm run dev

Voor deze opdracht is het gebruik van docker-compose niet toegestaan. Ook is het niet toegestaan om package managers te installeren in de container. Om onze mentale gezondheid te behouden heb ik daarom een PowerShell script geschreven. Dit script zorgt ervoor dat de containers worden gebouwd en gestart. Er is ook een script om de containers te stoppen en te verwijderen.

# Build the images
docker build -t myapp .
docker build -t mydb -f dockerfile.mysql .
docker build -t mycomposer -f dockerfile.composer .
docker build -t mynode -f dockerfile.node .

# Create the network
docker network create -d bridge larwork

# Run the containers
docker run --name mycomposer -d -v ${PWD}/src/:/var/app/ mycomposer
docker run --name mynode -d -v ${PWD}/src/:/var/app/ mynode
docker run --name mydb --network larwork -d -v ${PWD}/data/:/var/lib/mysql/ mydb
docker run --name myapp --network larwork -d -p 8080:80 -v ${PWD}/src/:/var/www/html/ myapp

# Give the right permissions to the containers
docker exec myapp /bin/bash -c 'chown -R www-data:www-data ./storage/'
docker exec myapp /bin/bash -c 'chmod -R 775 storage'

# Stop the containers
docker stop myapp
docker stop mydb
docker stop mycomposer
docker stop mynode

# Remove everything
docker system prune

Authenticatie (Opdracht 3)

De eerste opdracht is het maken van een authenticatie systeem. Dit is peroongelijk de derde opdracht van het project. Deze opdracht is gemaakt door middel van de ingebouwde functies van Laravel. Vervolgens staat alles klaar en kan er begonnen worden met het maken van de applicatie. Hiervoor is het volgende commando uitgevoerd:

docker exec mycomposer composer require laravel/breeze --dev
docker exec myapp php artisan breeze:install
docker exec php artisan migrate

CRUD (Opdracht 1)

De laatste stap voor de opdracht is het maken van een crud opdracht. Ik heb hiervoor een tabel gemaakt waar GitHub gebruikers in worden opgeslagen. Deze zullen laten in het project gebruikt worden om gegevens van te laden. Er is een mogelijkheid gemaakt voor gebruikers om hun Sociale Media accounts in te vullen. De instelling is verwerkt in de profiel pagina van het project. Er zijn twee tabellen gemaakt, eentje voor het bijhouden van de sociale media, en eentje voor de gebruikers. De tabel voor de gebruikers heeft een foreign key naar de tabel van de sociale media.

Schema::create('social_media_accounts', function (Blueprint $table) {
    $table->string('username');
    $table->string('social_media');
    
    $table->foreign('social_media')
            ->references('name')
            ->on('social_media')
            ->cascadeOnDelete();

    $table->foreignId('user_id')
            ->constrained()
            ->cascadeOnDelete();

    $table->primary(['social_media', 'user_id']);
});

Vervolgens worden de gegevens opgehaald in de model van de gebruiker, zodat deze overal beschikbaar zijn (read). Aanmaken, bijwerken en verwijderen gebeurd in de controller van de sociale media gebruiker. Dit gebeurd in één enkele functie.

/**
 * Update the social media accounts of the user
 * This will be called when the user submits the form on the profile page
 */
public function update() 
{
    // Get the data from the request and get the accounts
    $data = request()->all();
    $user = auth()->user();

    // Create an dictionary of the accounts given
    $givenAccounts = array(
        'GitHub' => $data['github'],
    );

    // Perform the right action for the given accounts
    foreach($givenAccounts as $media => $account) {
        $this->createAccountIfNotExists($user, $media, $account);
        $this->updateAccountWhenPresent($user, $media, $account);
        $this->deleteAccountWhenEmpty($user, $media, $account);
    }

    // Redirect back to the profile page
    return Redirect::route('profile.edit')->with('status', 'socials-updated');
}

Docker Compose (Opdracht 2)

Om Docker Compose toe te passen wordt er een docker-compose.yml bestand gemaakt. Hierin worden de containers gedefinieerd en de netwerken. We houden één dockerfile over, dit is de applicatie zelf. Deze veranderd niet ten opzichte van de eerdere versies.

version: '3'

# Setting up the network
networks:
  laravelnetwork:
    driver: bridge

# Setting up the services (containers)
services:
  # De laravel App
  laravel:
    build: ./
    networks:
      - laravelnetwork
    volumes:
      - ./src/:/var/www/html/
    ports:
      - 8080:80

MySQL, Node en Composer worden echter wel samengevoegd. Deze worden volledig gedefinieerd in het docker-compose.yml bestand. Zowel de gegevens van de dockerfiles als de powershell scripts worden hierin verwerkt. Het enige dat moet gebeuren is ./data/ in het project leeg maken. We hebben namelijk de naam van de database veranderd.

  mysql:
    image: mysql:8.0
    networks:
      - laravelnetwork
    volumes:
      - ./data:/var/lib/mysql
    ports:
      - 9090:3306
    environment:
      - "MYSQL_ROOT_PASSWORD=root"
      - "MYSQL_DATABASE=socialstats"

  node:
    image: node:latest
    networks:
      - laravelnetwork
    volumes:
      - ./src/:/var/app/
    ports:
      - 5173:5173
    working_dir: /var/app/
    command: npm install
    entrypoint: npm run dev

  composer:
    image: composer:latest
    volumes:
      - ./src/:/var/app/
    working_dir: /var/app/
    command: composer install