# Docker ## Installation {% hint style="info" %} Detta kräver att du har WSL2 installerat. Du kan kontrollera din version med Powershell, kör `wsl -l -v` {% endhint %} * Installera Windows Subsystem Linux 2, en guide finns [här](https://docs.microsoft.com/en-us/windows/wsl/install-win10). * Om du installerar en ny distribution: * `sudo apt update` * `sudo apt upgrade -y` * Installera [Docker desktop](https://www.docker.com/) 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](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl). 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](/files/-MKAM5Ntw5bkojy1-0QO) ![Fig 2, Resource settings. Välj den distribution du använder.](/files/-MKAM5NnIANwcGYYHvFi) 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. {% tabs %} {% tab title="Bash" %} ```bash docker ``` {% endtab %} {% endtabs %} ## 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. {% tabs %} {% tab title="Bash" %} ```bash mkdir wsp1-docker-node cd wsp1-docker-node express --view pug --css sass --git npm install ``` {% endtab %} {% endtabs %} För att underlätta utvecklingen används även nodemon. {% tabs %} {% tab title="Bash" %} ```bash npm install --save-dev nodemon ``` {% endtab %} {% endtabs %} Starta sedan Visual Studio Code. {% tabs %} {% tab title="Bash" %} ```bash code -r . ``` {% endtab %} {% endtabs %} Lägg sedan till följande kod så att nodemon körs. {% code title="package.json" %} ```javascript "scripts": { "start": "nodemon ./bin/www" }, ``` {% endcode %} ### 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. {% code title="docker-compose.yml" %} ```yaml 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" ``` {% endcode %} {% code title="Dockerfile" %} ```yaml FROM node:12 WORKDIR /var/www COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD ["npm", "start"] ``` {% endcode %} Om du har skapat Express-projektet, Docker-filerna och allt fungerar så är du redo att skapa en image och testa den. {% tabs %} {% tab title="Bash" %} ```bash docker-compose up -d ``` {% endtab %} {% endtabs %} 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. ](/files/-MKAus6LJwg8IkyKI83u) Öppna sedan projektet med Visual Studio Code och prova att redigera projektets index filer. Ladda sedan om sidan i webbläsaren. {% tabs %} {% tab title="JavaScript" %} {% code title="routes/index.js" %} ```javascript res.render('index', { title: 'Docker' }); ``` {% endcode %} {% endtab %} {% tab title="PUG" %} {% code title="views/index.pug" %} ```markup extends layout block content h1= title p Welcome to #{title}, this is amazing. ``` {% endcode %} {% endtab %} {% endtabs %} {% hint style="info" %} Koden för hela exemplet finns [här](https://github.com/jensnti/wsp1-docker-node). {% endhint %} ## Praktiskt Denna instruktion utgår från att du ska klona och köra igång ett repo, i detta fallet Soloäventyret. {% tabs %} {% tab title="Bash" %} ```bash git clone --single-branch --branch docker https://github.com/jensnti/wsp1-node-solo ``` {% endtab %} {% endtabs %} 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. * * * 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 {% tabs %} {% tab title="Bash" %} ```bash cd wsp1-node-solo npm install cp .env-example .env ``` {% endtab %} {% endtabs %} 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. {% tabs %} {% tab title="Bash" %} ```bash docker-compose up -d --build ``` {% endtab %} {% endtabs %} Om kommandot fungerar som det ska så startas dina containers, se Fig 3. ![Fig 3, wsp1-node-solo docker.](/files/-MKJrWEGCoklzmEWLebT) 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. {% tabs %} {% tab title="Bash" %} ```bash docker-compose exec db bash ``` {% endtab %} {% endtabs %} Väl inne startar du mysql som root. Lösenordet ska vara password123. ```yaml 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. {% tabs %} {% tab title="SQL" %} ```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; ``` {% endtab %} {% endtabs %} 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.](/files/-MKJtZ22dk7ipFDSY1On) Välj databas och sedan Import, databas-dumpen finns [här](https://raw.githubusercontent.com/jensnti/wsp1-node-solo/docker/dump.sql). Se Fig 5. ![Fig 5](/files/-MKJtj21Q9WWZtn78ZeA) Förhoppningsvis så kan du nu surfa till [localhost ](http://localhost:3000/)och testa äventyret. Om du behöver bygga om din image. {% tabs %} {% tab title="Bash" %} ```bash docker-compose up -d --build ``` {% endtab %} {% endtabs %} ## 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](http://localhost:3000) {% tabs %} {% tab title="Dockerfile" %} {% code title="Dockerfile" %} ```yaml 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"] ``` {% endcode %} {% endtab %} {% tab title="docker-compose.yml" %} {% code title="docker-compose.yml" %} ```yaml version: "3" services: node: image: "node:12" user: "node" working_dir: /var/www environment: - NODE_ENV=development volumes: - ./:/var/www ports: - ${port:-3000}:3000 # expose: # - "3000" command: "npm start" networks: - node-net #MySQL Service db: image: mysql:8.0.22 restart: unless-stopped tty: true command: '--character-set-server=utf8mb4' ports: - "3306:3306" environment: MYSQL_DATABASE: databasename MYSQL_ROOT_PASSWORD: password SERVICE_TAGS: dev SERVICE_NAME: mysql volumes: - dbdata:/var/lib/mysql/ - ./mysql/my.cnf:/etc/mysql/my.cnf networks: - node-net #Docker Networks networks: node-net: driver: bridge #Volumes volumes: dbdata: driver: local ``` {% endcode %} {% endtab %} {% tab title=".dockerignore" %} {% code title=".dockerignore" %} ``` node_modules npm-debug.log ``` {% endcode %} {% endtab %} {% tab title="my.cnf" %} {% code title="mysql/my.cnf" %} ```bash [mysqld] general_log = 1 general_log_file = /var/lib/mysql/general.log secure-file-priv = "" ``` {% endcode %} {% endtab %} {% endtabs %} För att konfigurera databasen behöver du koppla upp dig till den, skapa användaren och konfigurera rättigheterna. {% tabs %} {% tab title="SQL" %} ```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; ``` {% endtab %} {% endtabs %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://jens-andreasson.gitbook.io/webbserverprogrammering/containers/docker.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.