Instrukcja do szkolenia JWT
Ten dokument przeprowadzi Cię krok po kroku przez instalację narzędzi potrzebnych podczas szkolenia JWT.
Nagranie szkolenia znajdziesz tutaj.
tl;dr: Instalujemy Dockera a następnie budujemy specjalnie przygotowany do zajęć kontener - zawierający wszystkie potrzebne narzędzia.
Nie zapisałeś się jeszcze na szkolenie? Użyj poniższego formularza.
Instrukcja dla Windows
Najpierw musimy zainstalować narzędzie Docker.
Pobierz instalator klikając w ten link. Rozpocznij instalację. Oba "checkboxy" powinny być zaznaczone.
Po zakończeniu instalacji - uruchom komputer ponownie.
Po ponownym uruchomieniu komputera - zobaczysz informację, że instalacja jest niekompletna (jeżeli w przeszłości skonfigurowałeś WSL 2 - to okno może się nie pojawić).
Kliknij w odnośnik z informacji a następnie pobierz WSL2 Linux kernel update package for x64 machines.
Uruchom pobrany instalator. Instalacja jest krótka.
Po zakończeniu instalacji - konieczne może być ponowne uruchomienie komputera.
Na pulpicie została utworzona ikona "Docker Desktop". Kliknij w nią dwa razy.
Jeżeli wyświetlił Ci się błąd: "Please enable the Virtual Machine Platform Windows feature and ensure virtualization is enabled in the BIOS." oznacza to, że nie masz włączonej funkcji VT-x/AMD-v w swoim procesorze. Musisz ją włączyć i spróbować uruchomić Dockera ponownie. Więcej informacji o VT-x/ADM-v znajdziesz tutaj.
Jeżeli w lewym dolnym rogu widzisz zieloną ikonkę - oznacza to, że instalacja Dockera przebiegła prawidłowo.
Otwórz menu Start, wpisz w nim cmd i wybierz opcję "Uruchom jako administrator".
Teraz pobierz pliki potrzebne do laboratorium. W konsoli wklej:
mkdir c:\szkolenie_jwt
powershell -c (new-object System.Net.WebClient).DownloadFile('http://szurek.win/0/docker.zip','c:\szkolenie_jwt\docker.zip')
powershell -c "Expand-Archive -Path 'c:\szkolenie_jwt\docker.zip' -DestinationPath 'c:\szkolenie_jwt'"
Musimy jeszcze zbudować kontener - w konsoli ponownie wklej:
set DOCKER_BUILDKIT=0
set COMPOSE_DOCKER_CLI_BUILD=0
cd c:\szkolenie_jwt\
docker build -t szkolenie .
Jeśli wszystko przebiegło prawidłowo - jesteś gotowy do zajęć.
W każdej chwili możesz uruchomić kontener z potrzebnymi narzędziami.
W konsoli wklej:
docker run -it szkolenie
Masz teraz dostęp do ./jwt_tool.py
Instrukcja dla Linux
Instrukcja instalacji Dockera może się delikatnie różnić w zależności od dystrybucji, z której korzystasz.
Tutaj - znajdziesz bardziej szczegółową instrukcję.
Poniżej pokazuję proces instalacji na Ubuntu 20.04.
Otwórz konsolę i zainstaluj Dockera korzystając z automatycznej instalacji:
sudo apt update
sudo apt install curl unzip -y
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Teraz zbuduj kontener potrzebny podczas zajęć:
mkdir ~/szkolenie_jwt
curl http://szurek.win/0/docker.zip --output ~/szkolenie_jwt/docker.zip
unzip ~/szkolenie_jwt/docker.zip -d ~/szkolenie_jwt/
cd ~/szkolenie_jwt/
sudo docker build -t szkolenie .
Jeżeli wszystko przebiegło prawidłowo - możesz go uruchomić i korzystać z potrzebnych narzędzi:
sudo docker run -it szkolenie
Alternatywa - wykorzystanie DigitalOcean
Jeżeli nie chcesz instalować Dockera na swoim komputerze - możliwa jest trzecia opcja. Wymaga ona podania karty płatniczej i założenia konta w systemie DigitalOcean.
Załóż konto na stronie DigitalOcean. Możesz to zrobić z mojego polecenia klikając tutaj. Dzięki temu otrzymasz 100$, które możesz wykorzystać przez 60 dni.
Następnie stwórz nowy Droplet klikając tutaj (lub kliknij zielony guzik Create -> Droplets w prawym górnym rogu ekranu).
Z zakładki Marketplace wybierz Docker 19.
Do naszych ćwiczeń wystarczy najtańsza opcja - $5/mo.
Wybierz lokalizację serwera. Warto wybrać taki, który jest najbliżej nas.
Dalej wpisujemy hasło, które wykorzystamy do logowania się na nasz nowo stworzony serwer. Powinno być ono odpowiednio długie i skomplikowane (jeżeli wiesz co robisz - wybierz SSH keys - w tej instrukcji w ramach uproszczenia stosuję hasła).
Stworzenie serwera trwa kilka chwil. Więcej informacji możemy znaleźć w zakładce "Droplets" - po lewej stronie.
W kolejnym menu wyświetli się nam lista serwerów - kliknij we wcześniej wygenerowany serwer.
W prawym górnym rogu - znajduje się przycisk Console. Kliknij w niego.
Otworzy się okno, które pozwoli na zalogowanie się do serwera.
Wpisz jako login: root a następnie podaj hasło, które wybrałeś podczas tworzenia serwera.
Teraz wklej do konsoli (linijka po linijce):
sudo apt-get install curl unzip -y
mkdir ~/szkolenie_jwt
curl http://szurek.win/0/docker.zip --output ~/szkolenie_jwt/docker.zip
unzip ~/szkolenie_jwt/docker.zip -d ~/szkolenie_jwt/
cd ~/szkolenie_jwt/
sudo docker build -t szkolenie .
Jesteś już gotowy do zajęć. Wystarczy, że ponownie połączysz się do konsoli swojego serwera i po zalogowaniu wpiszesz:
sudo docker run -it szkolenie
Dzięki temu będziesz mieć dostęp do wszystkich potrzebnych narzędzi.
Używanie konsoli przez przeglądarkę jest niewygodne (nie działa kopiowanie).
Prościej jest użyć narzędzia Putty. Kliknij tutaj aby je pobrać.
Zaznacz opcję SSH a w polu Host Name wklej adres publiczny swojego serwera (jest on oznaczony jako ipv4 w konsoli DigitalOcean).
Następnie wciśnij przycisk "TAK" i zaloguj się jako root korzystając ze swojego hasła.
- Aby wkleić tekst - wciśnij prawy przycisk myszy
- Aby skopiować tekst - zaznacz go a następnie wciśnij prawy przycisk myszy
Uwaga: Stworzony przez Ciebie serwer kosztuje pięć dolarów miesięcznie. Po skończonych warsztatach - usuń droplet aby za niego nie płacić. Możesz to zrobić w zakładce "Destroy" klikając w czerwony guzik: "Destroy this Droplet".
