Wdrożenie dewelopera

Ten przewodnik opisuje, jak skonfigurować stację roboczą i rozpocząć pracę lokalną. Jeśli jakieś pojęcie jest nieznane, skorzystaj ze słownika inżynierskiego. Przeczytaj także wytyczne zarządzania czasem i produktywnością.

Aliasy powłoki

Dodaj aliasy do konfiguracji powłoki, np. ~/.bashrc. Skróty aktywują środowisko wirtualne Pythona, uruchamiają VPN i skracają typowe polecenia Dockera:

alias activate='source .venv/bin/activate && python3 --version && which python3 && pip --version'
alias python='python3'
alias venv='python3 -m venv .venv'
alias vpn='sudo wg-quick up wg0; sudo wg show'
alias vpn-down='sudo wg-quick down wg0'
alias dc='docker compose'

Po zapisaniu przeładuj konfigurację powłoki.

Konfiguracja stacji roboczej

1. Załóż konto GitLab na firmowy adres e-mail.
2. Wygeneruj klucz SSH:

ssh-keygen -t ed25519 -C "imie.nazwisko@pceuropa.net"
eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

3. Wyświetl klucz publiczny poleceniem cat ~/.ssh/id_ed25519.pub, a następnie dodaj go w GitLab > User Settings > SSH Keys.
4. Dodaj awatar w GitLabie, żeby łatwiej identyfikować aktywność w projekcie i recenzje.
5. Zainstaluj IDE lub edytor odpowiedni do developmentu w Pythonie.
6. Zaloguj się do workspace’u Slack PCEUROPA.
7. Otwórz projekt whole_internet w GitLabie, wybierz Code, skopiuj adres Clone with SSH i wykonaj:

git clone <ssh-url>

8. Sprawdź, czy wersja Pythona zgadza się z wersją wymaganą przez projekt:

python3 --version

9. Zainstaluj MongoDB Compass i IPython:

sudo apt install ipython3

10. Poproś swojego buddy o autoryzowany dostęp do deweloperskiej bazy danych. W razie potrzeby lokalnej kopii użyj DB_URI z crawler/.env wraz z mongodump i mongorestore. Nigdy nie commituj poświadczeń ani zrzutów bazy.

Uruchomienie środowiska lokalnego

1. Wejdź do katalogu crawlera:

cd ~/crawler

2. Utwórz środowisko wirtualne:

python3 -m venv .venv

3. Aktywuj je i sprawdź aktywne narzędzia:

source .venv/bin/activate
python3 --version
which python3
pip --version