Přeskočit obsah

Docker: RealTestData API a WEB spuštěné na Dockeru

Tato dokumentace popisuje, jak nainstalovat Docker Engine a jak nainstalovat a spustit lokální obraz Dockeru pro RealTestData API a WEB z Windows, Mac a Linux.

Krok 1 - Instalace IDE nebo démona kompatibilního s Dockerem

Ve Windows

Možnost 1: Docker Desktop (doporučeno)

  1. Stáhněte si Docker Desktop
  2. Přejděte na https://www.docker.com/products/docker-desktop/
  3. Stáhněte si Docker Desktop pro Windows

  4. Vyžaduje Windows 10/11 Pro, Enterprise nebo Education (64bitová verze)

  5. Nainstalujte Docker Desktop

  6. Spusťte instalační program jako správce
  7. Postupujte podle pokynů průvodce instalací
  8. Po zobrazení výzvy povolte integraci WSL 2

  9. Po dokončení instalace restartujte počítač

  10. Spusťte Docker Desktop

  11. Spusťte Docker Desktop z nabídky Start
  12. Počkejte na spuštění Docker Engine (ikona velryby v systémové liště)

  13. Měli byste vidět stav „Docker Desktop běží“

  14. Ověřte instalaci

docker --version
docker run hello-world

Možnost 2: Docker Engine (pouze z příkazového řádku)

  1. Povolit WSL 2
# Spustit v PowerShellu jako správce wsl --install
  1. Nainstalovat Docker Engine do WSL 2
# V terminálu WSL 2 curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Možnost 3: Rancher Desktop (alternativa)

  1. Stáhnout z https://rancherdesktop.io/
  2. Nainstalovat a nakonfigurovat pomocí dockerd runtime
  3. Ověřit pomocí docker --version

Systémové požadavky

  • Windows 10 verze 2004 nebo vyšší (Build 19041 nebo vyšší)
  • Funkce WSL 2 povolena
  • Virtualizace povolena v BIOSu
  • Alespoň 4 GB RAM (doporučeno 8 GB)

Řešení problémů

  • Pokud se Docker Desktop nespustí, ujistěte se, že je virtualizace povolena v BIOSu
  • V případě problémů s WSL 2 spusťte: wsl --update
  • Zkontrolujte funkce systému Windows: Zapněte/vypněte funkce systému Windows → Povolte „Platformu virtuálního počítače“ a „Subsystém systému Windows pro Linux“

Na Macu

Možnost 1: Docker Desktop (doporučeno)

  1. Stáhněte si Docker Desktop
  2. Přejděte na https://www.docker.com/products/docker-desktop/
  3. Vyberte příslušnou verzi:
  4. Apple Silicon (M1/M2/M3): Stáhněte si „Mac s čipem Apple“

  5. Intel Mac: Stáhněte si „Mac s čipem Intel“

  6. Nainstalujte Docker Desktop

  7. Otevřete stažený soubor .dmg
  8. Přetáhněte Docker do složky Aplikace
  9. Spusťte Docker z Aplikace

  10. Po zobrazení výzvy udělte potřebná oprávnění

  11. Spusťte Docker Desktop

  12. Docker se spustí automaticky po instalaci
  13. V liště nabídek hledejte ikonu Docker Whale

  14. Kliknutím na ikonu zobrazíte zprávu „Docker Desktop běží“

  15. Ověřte instalaci

docker --version
docker run hello-world

Možnost 2: Docker Engine přes Homebrew

  1. Nainstalujte Homebrew (pokud již není nainstalován)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Nainstalujte Docker
brew install docker
brew install docker-compose
  1. Spusťte Docker Service
brew services start docker

Možnost 3: Rancher Desktop (Alternativa)

  1. Stáhněte z https://rancherdesktop.io/
  2. Nainstalujte balíček .dmg
  3. Nakonfigurujte pomocí dockerd runtime
  4. Ověřte pomocí docker --version

Systémové požadavky (Mac)

  • macOS 10.15 nebo novější
  • Alespoň 4 GB RAM (doporučeno 8 GB)
  • VirtualBox starší verze 4.3.30 nesmí být nainstalován

V Linuxu

Možnost 1: Docker Engine (oficiální repozitář)

Pro Ubuntu/Debian: 1. Aktualizujte index balíčků

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg lsb-release
  1. Přidejte oficiální GPG klíč Dockeru
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
  1. Nastavení repozitáře
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
  1. Instalace Docker Engine
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
  1. Přidání uživatele do skupiny docker
sudo usermod -aG docker $USER
newgrp docker

Pro CentOS/RHEL/Fedora: 1. Instalace pomocí yum/dnf

# CentOS/RHEL
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install docker-ce docker-ce-cli container.io docker-buildx-plugin docker-compose-plugin

# Fedora
sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
sudo dnf install docker-ce docker-ce-cli container.io docker-buildx-plugin docker-compose-plugin
  1. Spuštění služby Docker
sudo system

ctl start docker
sudo systemctl enable docker
  1. Přidat uživatele do skupiny docker
sudo usermod -aG docker $USER

Možnost 2: Docker Desktop pro Linux

  1. Stáhnout z https://www.docker.com/products/docker-desktop/
  2. Nainstalovat balíček
# Ubuntu/Debian
sudo dpkg -i docker-desktop-<verze>-<arch>.deb

# RHEL/Fedora
sudo rpm -i docker-desktop-<verze>-<arch>.rpm

Možnost 3: Skript pro rychlou instalaci

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
sudo usermod -aG docker $USER

Systémové požadavky (Linux)

  • Podpora 64bitového jádra a CPU pro virtualizaci
  • Podpora virtualizace KVM
  • QEMU musí být verze 5.2 nebo novější
  • systemd init system
  • Alespoň 4 GB RAM (doporučeno 8 GB)

Ověření instalace (všechny platformy)

Po instalaci na jakékoli platformě ověřte, zda Docker funguje:

docker --version
docker run hello-world
docker ps

Měli byste vidět: - Informace o verzi Dockeru - Zprávu „Hello from Docker!“ - Seznam prázdných kontejnerů (zpočátku)

Krok 2 - Stáhněte a spusťte obrazy Dockeru RealTestData

RealTestData má 2 obrazy Dockeru a několik svazků Dockeru s daty. Pro instalaci a spuštění obrazů jako kontejnerů poskytujeme skript pro Windows a Mac/Linux.

Po stažení našeho balíčku API-WEB jsou zahrnuty 4 soubory:

  • rtdall-start.bat pro Windows
  • rtdall-start.sh pro Mac/Linux

Po spuštění tohoto skriptu se obrazy stáhnou nebo aktualizují z DockerHubu.

Obrazy RTDVOLS stahují/aktualizují všechny potřebné svazky a přidávají je do lokálního repozitáře svazků nebo je aktualizují v lokálním repozitáři.

  • rtdall-start-container.bat pro Windows
  • rtdall-start-container.sh pro Mac/Linux

Tyto skripty slouží ke spuštění kontejnerů pouze v případě, že se zastavily. Nemusíte spouštět rtdall-start podruhé, když je vše lokálně a aktuální.

Pravidelně aktualizujte všechny svazky.

Kontrola lokálně dostupných zdrojů Dockeru

Před spuštěním skriptů si můžete ověřit, jaké obrazy a svazky Dockeru jsou již lokálně dostupné:

Kontrola obrazů Dockeru

# Zobrazení všech lokálních obrazů Dockeru
obrázky Dockeru

# Kontrola konkrétního obrazu
obrázky Dockeru realtestdata/rtdapi
obrázky Dockeru realtestdata/rtdweb
obrázky Dockeru realtestdata/rtdvols

Kontrola svazků Dockeru

# Zobrazení všech lokálních svazků Dockeru
docker volume ls

# Získání podrobných informací o konkrétním svazku
docker volume inspect configdata
docker volume inspect resultdata

Kontrola spuštěných kontejnerů

# Zobrazení všech spuštěných kontejnerů
docker ps

# Zobrazení všech kontejnerů (spuštěných i zastavených)
docker ps -a

Kontrola sítí Dockeru

# Zobrazení všech sítí
docker network ls

Kompletní přehled systému

# Získat kompletní informace o systému Docker
docker system df

# Zobrazit využití disku komponentami Dockeru
docker system df -v

# Zobrazit podrobné informace o systému
docker info

Očekávané lokální zdroje

Po úspěšném spuštění instalačních skriptů byste měli vidět:

Obrázky: - realtestdata/rtdapi:latest - realtestdata/rtdweb:latest - realtestdata/rtdvols:latest

Svazky: - configdata - resultdata - database - full - trial - doc

Síť: - rtdnet

Spuštěné kontejnery: - rtdapi-container (port 8000) - rtdweb-container (port 5000)

Krok 3 - Spusťte webového klienta RealTestData

Před přístupem k webovému rozhraní zkontrolujte, zda API běží: localhost:8000 by mělo zobrazit “Toto je RealTestData API”

Nyní otevřete webový prohlížeč dle vašeho výběru a zadejte localhost:5000 jako URL.

Měli byste vidět domovskou stránku RealTestData. Pro přihlášení se musíte zaregistrovat pomocí tlačítka “Registrovat”. Bude vám vytvořen zkušební uživatel.

2 zkušební uživatelé již existují: trial/trial test/test

Můžete vytvořit až 2 další zkušební uživatele.

Pomocí tlačítka “Generovat” můžete vygenerovat soubor s výsledky, který se stáhne. Jakmile to funguje, podívejte se na různá nastavení.

Krok 4 - Použití API bez webového klienta.

API můžete použít bez webového klienta. Příklad Pythonu najdete v souboru ZIP: RealTestData_API_Generate.py.

Když zavoláte API ve webovém prohlížeči a zadáte localhost:8000/docs/en, zobrazí se vám anglická (nebo de - německá či cz - česká) dokumentace k API.

Volání localhost:8000/generate_live vygeneruje data, která jste zadali ve webovém klientovi, jako JSON stream. Tento stream můžete integrovat do vašeho CI/CD pipeline.