Docker

Installation

Detta kräver att du har WSL2 installerat. Du kan kontrollera din version med Powershell, kör wsl -l -v

• Installera Windows Subsystem Linux 2, en guide finns här.

  • Om du installerar en ny distribution:

    • sudo apt update

    • sudo apt upgrade -y

• Installera Docker desktop för Windows.

  • Kör igenom Dockers Get started Tutorial i programmet.

• Se till att du har Remote extension för Visual Studio Code, den här.

Nästa steg är att konfigurera Docker så att det använder WSL2, se fig 1 och att det har tillgång till WSL, fig 2.

Fig 1, General settings för Docker

Fig 2, Resource settings. Välj den distribution du använder.

Du kan eventuellt behöva starta om datorn, WSL och eller Docker efter detta. Men du ska kunna starta WSL och köra kommandot docker. Docker körs då från Windows, men finns tillgängligt från WSL.

Bash

docker

Ett första test med Node

Innan du kommer igång så krävs det att du installerar lite programvara lokalt.

sudo apt install curl dirmngr apt-transport-https lsb-release ca-certificates -y
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt install nodejs -y
sudo npm i -g express express-generator

Nästa steg är att skapa ett Express-projekt som kommer utgöra basen för denna container.

Bash

mkdir wsp1-docker-node
cd wsp1-docker-node
express --view pug --css sass --git
npm install

För att underlätta utvecklingen används även nodemon.

Bash

npm install --save-dev nodemon

Starta sedan Visual Studio Code.

Bash

code -r .

Lägg sedan till följande kod så att nodemon körs.

package.json

  "scripts": {
    "start": "nodemon ./bin/www"
  },

Docker filer

Docker utgår från ett antal konfigurationsfiler för att skapa en image. Denna image är det som körs och används i en Docker container. Skapa följande filer i projektmappen.

docker-compose.yml

version: "3"
services:
  node:
    container_name: nodejs
    image: "node:12"
    user: "node"
    working_dir: /var/www
    environment:
      - NODE_ENV=development
    volumes:
      - ./:/var/www
    ports:
    - "3000:3000"
    command: "npm start"

Dockerfile

FROM node:12
WORKDIR /var/www
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "start"]

Om du har skapat Express-projektet, Docker-filerna och allt fungerar så är du redo att skapa en image och testa den.

Bash

docker-compose up -d

Vänta på att imagen ska skapas, sedan öppnar du Docker-gränssnittet. Navigera till Containers och prova att öppna projektet i en webbläsare. Om allt fungerar så öppnas ditt Express projekt.

Fig 3, Docker image running.

Öppna sedan projektet med Visual Studio Code och prova att redigera projektets index filer. Ladda sedan om sidan i webbläsaren.

JavaScript

routes/index.js

res.render('index', { title: 'Docker' });

PUG

Koden för hela exemplet finns här.

Praktiskt

Denna instruktion utgår från att du ska klona och köra igång ett repo, i detta fallet Soloäventyret.

Bash

git clone --single-branch --branch docker https://github.com/jensnti/wsp1-node-solo

Docker filerna följer med för detta, vill du klona ditt eget soloäventyr så är det följande filer du behöver. Notera mappen för my.cnf.

• https://raw.githubusercontent.com/jensnti/wsp1-node-solo/docker/docker-compose.yml

• https://github.com/jensnti/wsp1-node-solo/blob/docker/Dockerfile

• https://github.com/jensnti/wsp1-node-solo/blob/docker/mysql/my.cnf

Filerna kommer att starta 2 containers.

• nodedev

  • Kör node:12.

  • Kör npm start från package.json

  • På port 3000

• nodedb

  • Kör mysql:8

  • Skapar användare och databas.

    • database: soloadventure

    • root password: password123

Bash

cd wsp1-node-solo
npm install
cp .env-example .env

Efter att projektet klonats ned och install är kört så behöver det köras lite kommandon för att få allt att fungera. Kör följande kommando för att bygga en image och starta den som en tjänst.

Bash

docker-compose up -d --build

Om kommandot fungerar som det ska så startas dina containers, se Fig 3.

Fig 3, wsp1-node-solo docker.

Nästa steg blir att slutföra konfigurationen av databasanvändaren och ladda in databasen. För att göra det behöver du koppla upp dig mot databas-containers bash.

Bash

docker-compose exec db bash

Väl inne startar du mysql som root. Lösenordet ska vara password123.

mysql -u root -p 

Användaren till kontot skapades tillsammans med databasen tidigare, men permissions behövs fortfarande sättas och uppdateras för node.

SQL

CREATE USER 'solouser'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON soloadventure.* TO 'solouser'@'%';
ALTER USER 'solouser'@'%' IDENTIFIED WITH mysql_native_password BY 'password';
FLUSH PRIVILEGES;

När detta är gjort så är det sista steget att importera databasen. Detta kan vi göra med tableplus. Skapa en ny uppkoppling, Fig 4.

Fig 4, Create new connection.

Välj databas och sedan Import, databas-dumpen finns här. Se Fig 5.

Fig 5

Förhoppningsvis så kan du nu surfa till localhost och testa äventyret. Om du behöver bygga om din image.

Bash

docker-compose up -d --build

Snabbstart

Filer för att skapa en image med node, npm och databas.

• Skapa ett nytt Express-projekt eller klona ett från Git.

• Skapa följande konfigurationsfiler i mappen.

• Se till att Docker är igång.

• Kör docker-compose up -d build

• Du bör nu kunna surfa till localhost

Dockerfile

Dockerfile

FROM node:12

# Create app directory
WORKDIR /var/www

# Install app dependencies
# A wildcard is used to ensure both package.json AND package-lock.json are copied
# where available (npm@5+)
COPY package*.json ./

RUN npm install
# If you are building your code for production
# RUN npm ci --only=production

# Add user for application
RUN groupadd -g 1000 www
RUN useradd -u 1000 -ms /bin/bash -g www www

# Bundle app source
COPY . .

# Change current user to www
USER www

EXPOSE 3000

CMD ["npm", "start"]

docker-compose.yml

.dockerignore

my.cnf

För att konfigurera databasen behöver du koppla upp dig till den, skapa användaren och konfigurera rättigheterna.

SQL

CREATE USER 'username'@'%' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON databasename.* TO 'username'@'%';
ALTER USER 'username'@'%' IDENTIFIED WITH mysql_native_password BY 'password';
FLUSH PRIVILEGES;