cheatsheets

Docker Cheatsheet

Spis treści

• Docker
  • Obrazy
  • Kontenery
• Konfiguracja
  • Dockerfile
  • .dockerignore
  • docker-compose.yaml
• Dodatkowo
  • Kubernetes

---

Logowanie

docker login

Dockerfile

FORM node:11.6.0-alpine
COPY ...
RUN ...
CMD ...

Budowanie obrazu

docker build -t piecioshka/demo:1 .

Usuwanie obrazu

docker rmi piecioshka/demo:1

Uruchamianie kontenera

docker run piecioshka/demo
docker run -it piecioshka/demo
docker run -it -p 8000:3000 piecioshka/demo:1
docker run -it -p 8000:3000 -v ~/projects/test-app:/home/node/app piecioshka/demo:1

Zatrzymywanie kontenera

docker stop piecioshka/demo:1
docker kill piecioshka/demo:1

Lista kontenerów

docker ps       # Tylko uruchomionych
docker ps -a    # Wszystkich stworzonych

Usuwanie cache-a

docker system prune -a

Wyświetlenie aktualnych zdarzeń

docker events

Zalogowanie się na kontener

docker exec -it piecioshka/demo:1 bash

---

Dockerfile

Polecenia

• FROM - źródło budowania obrazu
• WORKDIR - ustawienie katalogu w którym będą wykonywane kolejne zadania
• COPY - kopiowanie pliku z systemu operacyjnego do obrazu
• RUN - uruchomienie polecenia na potrzeby zbudowania obrazu
• CMD — uruchomienie polecenia po starcie kontenera

💡 Hint: Po instalacji pluginu “Docker” w edytorze Visual Studio Code, podczas wypełniania pliku Dockerfile będziemy otrzymywali podpowiedzi.

Polecenie FROM

Przykład użycia:

• FROM node — Stabilna wersja obrazu ze skonfigurowanym Node.js
• FROM busybox — Uniwersalny obraz
• FROM node:11.14.0-alpine — Minimalistyczna wersja obrazu z Alpine Linux

Polecenie WORKDIR

Przykład użycia:

• WORKDIR /home/node/app
• WORKDIR /app

Polecenie COPY

Przykład użycia:

• COPY . . — brak cache-a dockerowego
• COPY package*.json ./

Polecenie RUN

Przykład użycia:

• RUN npm install

Polecenie CMD

Przykład użycia:

• CMD npm run dev
• CMD ["npm", "run", "dev"]

---

.dockerignore

Plik zawierający ścieżki do plików i katalogów, które będą ignorowane podczas budowania obrazu.

---

docker-compose.yaml

• Proste zarządzenie kilkoma kontenerami
• Zarządzanie mikroserwisami

Must have

• Definicja wersji
• Definicja listy serwisów

Możliwości

• Zdefiniowanie kontekstu (katalogu z plikiem Dockerfile)

    build: .
  

• Mapowanie portów, przykład:

    ports:
      - 80:4200
  

• Mapowanie katalogu, przykład:

    volumes:
      - ./:/app/
  

Użycie

# Uruchom kontenery na podstawie już stworzonych obrazów (jeśli nie istnieją zbuduje je)
docker-compose up

# Zbuduje obrazy ponownie, przed wystartowaniem kontenerów
docker-compose up --build

---

Docker — Kontenery

Uruchamianie

# Zwykłe zbudowanie i uruchomienie kontenera na podstawie obrazu
docker run IMAGE_NAME

# Wyjście z polecenie za pomocą <kbd>Ctrl+C</kbd> zatrzymuje kontener:
docker run -it IMAGE_NAME

# Usuń kontener stworzony z tego obrazu (jeśli istnieje)
docker run --rm IMAGE_NAME

Zatrzymywanie

docker stop IMAGE_ID
docker kill IMAGE_ID

Lista

# Tylko uruchomione
docker ps

# Wszystkie
docker ps -a

Zmiany które nastąpiły w kontenerze

docker diff

Logujemy się na uruchomiony kontener

Aby uruchomić powłokę bash na kontenerze o id = CONTAINER_ID uruchom następujące polecenie:

docker exec -it CONTAINER_ID bash

---

Współdzielenie portu

docker run -p TARGET:SOURCE IMAGE_NAME

Uruchomienie kontenera z parametrem -v. Opis parametrów:

• TARGET - port w w systemie operacyjnym
• SOURCE - port w aplikacji uruchomionej w kontenerze
• IMAGE_NAME - nazwa obrazu z którego zostanie stworzony kontener

Przykład:

docker run \
    -p 8000:3000 \
    piecioshka/demo:2

Współdzielenie katalogu (mapowanie)

docker run -v SOURCE:TARGET IMAGE_NAME

Uruchomienie kontenera z parametrem -v. Opis parametrów:

• SOURCE — katalog na dysku komputera
• TARGET — katalog na kontenerze
• IMAGE_NAME - nazwa obrazu z którego zostanie stworzony kontener

Przykład:

docker run \
    -p 8000:3000 \
    -v ~/projects/test-docker-http/:/home/node/app/ \
    piecioshka/demo:2

Współdzielenie sieci

docker run --network=NETWORK_NAME IMAGE_NAME

Współdzielenie tego samego interfejsu sieciowego na kontenerze

• NETWORK_NAME — nazwa sieci
• IMAGE_NAME - nazwa obrazu z którego zostanie stworzony kontener

Przykład:

docker run --network=host busybox

---

Docker — Obrazy

Budowanie

docker build -t NAME PATH

• NAME — nazwa stworzonego obrazu, szablon owner-or-company/imagename:version
• PATH — tzw. context (zwykle zawiera plik Dockerfile)

Przykład:

docker build -t piecioshka/demo:1 .

Usuwanie

docker rmi [REPOSITORY:TAG|IMAGE_ID]

Przykład:

docker rmi node:11

---

Docker

Instalacja

1. Pobrać plik binarny ze strony https://docker.com
2. Stworzyć konto na https://hub.docker.com
3. Uruchomić na komputerze docker login

Kontener to nie maszyna wirtualna

• Nie ma Hypervisora, np. VirtualBox
• Nie ma managera pamięci
• Namespace linuxowy (pid, net, users
  • ma swój pid — nie widać na kontenerze procesów hosta
  • ma swoje wirtualne interfejsy sieciowy i tablicę routingu
  • ma własną definicję użytkowników i grup

Źródło: https://blog.netapp.com/blogs/containers-vs-vms/

overlay2

• Warstwowy system plików

Źródło: https://docs.docker.com/storage/storagedriver/overlayfs-driver/

Usuwanie cache-a

docker system prune -a

• Usunięcie zbudowanych obrazów
• Usunięcie zbudowanych sieci
• Usunięcie zbudowanych kontenerów

Zdarzenia Docker-a

Uruchom dwa okna terminala:

1. W pierwszy uruchom

    docker events
   

2. W drugim:

   • zbuduj obraz
   • lub uruchom kontener.

Ogólne informacje

docker info

---

Kubernetes

Zaawansowane zarządzenie kontenerami

• https://kubernetes.io/docs/tutorials/
• https://kubernetestutorials.com/

---

Polecane źródła

• https://www.youtube.com/watch?v=P4ZC3cFN0WQ
• https://www.youtube.com/watch?v=jqGrBffAs5M
• https://docs.docker.com/develop/develop-images/dockerfile_best-practices/
• https://github.com/wsargent/docker-cheat-sheet

---

Projekty

• https://github.com/piecioshka/test-docker-express-mongo
  • Uruchom serwer HTTP w oparciu o Express.js
  • Uruchom bazę danych np. MongoDB
  • Nawiąż połączenie między dwoma kontenerami
• https://github.com/piecioshka/test-docker
  • Stwórz plik src/index.js
  • Stwórz i skonfiguruj plik Dockerfile
  • Stwórz i skonfiguruj plik .dockerignore
• https://github.com/piecioshka/test-docker-http
  • Stwórz plik src/index.js
  • Stwórz server HTTP (connect + morgan)
  • Stwórz i skonfiguruj plik Dockerfile
  • Edytuj plik src/index.js, czy masz wpływ na odpowiedź