![\"przyk\u0142ad](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/01-What-Are-Environment-Variables.jpg\")
<\/figure>\n\n\n\nZmienne \u015brodowiskowe to dynamiczne warto\u015bci nazwane, kt\u00f3re mog\u0105 wp\u0142ywa\u0107 na zachowanie dzia\u0142aj\u0105cych proces\u00f3w w komputerze. Niekt\u00f3re kluczowe w\u0142a\u015bciwo\u015bci zmiennych \u015brodowiskowych to:<\/p>\n\n\n\n
- \n
- Nazwane<\/strong>: Maj\u0105 opisowe nazwy zmiennych takie jak APP_MODE<\/em> i DB_URL<\/em>.<\/li>\n\n\n\n
- Zewn\u0119trzne<\/strong>: Warto\u015bci s\u0105 ustawiane poza kodem aplikacji za pomoc\u0105 plik\u00f3w, linii komend i system\u00f3w.<\/li>\n\n\n\n
- Dynamiczne<\/strong>: Mo\u017cliwo\u015b\u0107 aktualizacji zmiennych bez restartowania aplikacji.<\/li>\n\n\n\n
- Konfigurowalne<\/strong>: Kod polega na zmiennych, ale ich nie definiuje.<\/li>\n\n\n\n
- Od\u0142\u0105czone<\/strong>: Nie ma potrzeby zmiany konfiguracji kodu, gdy zmienne s\u0105 ustawione.<\/li>\n\n\n<\/ul>\n\n\n\n
Oto analogia<\/strong>. Wyobra\u017a sobie, \u017ce post\u0119pujesz zgodnie z przepisem na ciasteczka z kawa\u0142kami czekolady. Przepis mo\u017ce brzmie\u0107:<\/p>\n\n\n\n
- \n
- Dodaj 1 szklank\u0119 cukru<\/li>\n\n\n\n
- Dodaj 1 kostk\u0119 mi\u0119kkiego mas\u0142a<\/li>\n\n\n\n
- Dodaj 2 jajka<\/li>\n\n\n<\/ul>\n\n\n\n
Zamiast tych sta\u0142ych warto\u015bci, mo\u017cesz u\u017cy\u0107 zmiennych \u015brodowiskowych:<\/p>\n\n\n\n
- \n
- Dodaj $SUGAR szklanki cukru<\/li>\n\n\n\n
- Dodaj $BUTTER kostki mi\u0119kkiego mas\u0142a<\/li>\n\n\n\n
- Dodaj $EGGS jajka<\/li>\n\n\n<\/ul>\n\n\n\n
Przed przygotowaniem ciasteczek, ustawi\u0142by\u015b nazwy zmiennych \u015brodowiskowych na warto\u015bci wed\u0142ug w\u0142asnego wyboru:<\/p>\n\n\n\n
SUGAR=1 \nBUTTER=1\nEGGS=2<\/code><\/pre>\n\n\n\nWi\u0119c, kiedy b\u0119dziesz stosowa\u0107 przepis, twoje sk\u0142adniki b\u0119d\u0105 si\u0119 sprowadza\u0107 do:<\/p>\n\n\n\n
- \n
- Dodaj 1 szklank\u0119 cukru<\/li>\n\n\n\n
- Dodaj 1 kostk\u0119 mi\u0119kkiego mas\u0142a<\/li>\n\n\n\n
- Dodaj 2 jajka<\/li>\n\n\n<\/ul>\n\n\n\n
To pozwala na konfiguracj\u0119 przepisu na ciasteczka bez zmiany kodu przepisu.<\/p>\n\n\n\n
Ta sama koncepcja dotyczy oblicze\u0144 i rozwoju. Zmienne \u015brodowiskowe pozwalaj\u0105 zmienia\u0107 \u015brodowisko, w kt\u00f3rym dzia\u0142a proces, bez zmiany podstawowego kodu. Oto kilka powszechnych przyk\u0142ad\u00f3w:<\/p>\n\n\n\n
- \n
- Ustawienie \u015brodowiska na “development” lub “production”<\/li>\n\n\n\n
- Konfigurowanie kluczy API dla us\u0142ug zewn\u0119trznych<\/li>\n\n\n\n
- Przekazywanie tajnych kluczy lub danych uwierzytelniaj\u0105cych<\/li>\n\n\n\n
- Prze\u0142\u0105czanie niekt\u00f3rych funkcji w\u0142\u0105cz\/wy\u0142\u0105cz<\/li>\n\n\n<\/ul>\n\n\n\n
Zmienne \u015brodowiskowe zapewniaj\u0105 du\u017c\u0105 elastyczno\u015b\u0107. Mo\u017cesz uruchomi\u0107 ten sam kod w wielu \u015brodowiskach, nie zmieniaj\u0105c samego kodu. Ale zrozummy dalej, dlaczego s\u0105 one cenne.<\/p>\n\n\n\n
Dlaczego zmienne \u015brodowiskowe s\u0105 cenne?<\/h2>\n\n\n\n
![\"zmienne](\"data:image\/svg+xml;base64,PHN2ZyB3aWR0aD0iMSIgaGVpZ2h0PSIxIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPjwvc3ZnPg==\")
<\/figure>\n\n\n\nRozwa\u017c zmienne \u015brodowiskowe jako pokr\u0119t\u0142a aplikacji u\u017cywane do dostosowywania preferencji. Wkr\u00f3tce przeanalizujemy doskona\u0142e przypadki u\u017cycia.<\/p>\n\n\n\n
Ugruntujmy intuicj\u0119, dlaczego zmienne \u015brodowiskowe s\u0105 wa\u017cne!<\/p>\n\n\n\n
Pow\u00f3d #1: Oddzielaj\u0105 kod aplikacji od konfiguracji<\/h3>\n\n\n\n
<\/figure>\n\n\n\nBezpo\u015brednie wpisywanie konfiguracji i po\u015bwiadcze\u0144 w kodzie mo\u017ce powodowa\u0107 r\u00f3\u017cnego rodzaju problemy:<\/p>\n\n\n\n
- \n
- Niechciane zatwierdzenia do kontroli \u017ar\u00f3d\u0142a<\/li>\n\n\n\n
- Przebudowa i ponowne wdra\u017canie kodu tylko po to, aby zmieni\u0107 warto\u015b\u0107<\/li>\n\n\n\n
- Problemy z konfiguracj\u0105 podczas promowania przez \u015brodowiska<\/li>\n\n\n<\/ul>\n\n\n\n
To prowadzi r\u00f3wnie\u017c do nieporz\u0105dnego kodu:<\/p>\n\n\n\n
import os\n\n# Konfiguracja zakodowana na sta\u0142e\nDB_USER = 'appuser' \nDB_PASS = 'password123'\nDB_HOST = 'localhost'\nDB_NAME = 'myappdb'\n\ndef connect_to_db():\n print(f\"\u0141\u0105czenie z {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}\") \n\nconnect_to_db()<\/code><\/pre>\n\n\n\nTo splata logik\u0119 biznesow\u0105 z detalami konfiguracji. \u015acis\u0142e powi\u0105zanie sprawia, \u017ce utrzymanie staje si\u0119 z czasem uci\u0105\u017cliwe:<\/p>\n\n\n\n
- \n
- Zmiany wymagaj\u0105 modyfikacji kodu \u017ar\u00f3d\u0142owego<\/li>\n\n\n\n
- Ryzyko wycieku sekret\u00f3w do kontroli \u017ar\u00f3d\u0142a<\/li>\n\n\n<\/ul>\n\n\n\n
U\u017cywanie zmiennych \u015brodowiskowych zmniejsza te problemy. Na przyk\u0142ad, mo\u017cesz ustawi\u0107 zmienne \u015brodowiskowe DB_USER i DB_NAME.<\/p>\n\n\n\n
# .env file\nDB_USER=appuser\nDB_PASS=password123 \nDB_HOST=localhost\nDB_NAME=myappdb<\/code><\/pre>\n\n\n\nKod aplikacji mo\u017ce uzyskiwa\u0107 dost\u0119p do zmiennych \u015brodowiskowych w razie potrzeby, co utrzymuje kod czysty i prosty.<\/p>\n\n\n\n
import os\n\n# Wczytaj konfiguracj\u0119 ze zmiennych \u015brodowiskowych\nDB_USER = os.environ['DB_USER']\nDB_PASS = os.environ['DB_PASS'] \nDB_HOST = os.environ['DB_HOST']\nDB_NAME = os.environ['DB_NAME']\n\ndef connect_to_db():\n print(f\"\u0141\u0105czenie z {DB_USER}:{DB_PASS}@{DB_HOST}\/{DB_NAME}\")\n \nconnect_to_db()<\/code><\/pre>\n\n\n\nZmienne \u015brodowiskowe wyra\u017anie oddzielaj\u0105 konfiguracj\u0119 od kodu, zachowuj\u0105c wra\u017cliwe warto\u015bci abstrakcyjnie w \u015brodowisku.<\/p>\n\n\n\n
Mo\u017cesz wdro\u017cy\u0107 ten sam kod z rozwoju do produkcji, nie zmieniaj\u0105c niczego. Zmienne \u015brodowiskowe mog\u0105 r\u00f3\u017cni\u0107 si\u0119 mi\u0119dzy \u015brodowiskami, nie wp\u0142ywaj\u0105c w og\u00f3le na kod.<\/p>\n\n\n\n
Pow\u00f3d nr 2: Uproszczaj\u0105 konfiguracj\u0119 aplikacji<\/h3>\n\n\n\n
<\/figure>\n\n\n\nZmienne \u015brodowiskowe u\u0142atwiaj\u0105 dostosowywanie konfiguracji bez ingerencji w kod:<\/p>\n\n\n\n
# Plik .env:\nDEBUG=true<\/code><\/pre>\n\n\n\nOto jak mo\u017cemy tego u\u017cy\u0107 w pliku skryptu:<\/p>\n\n\n\n
# Zawarto\u015b\u0107 skryptu:\nimport os\n\nDEBUG = os.environ.get('DEBUG') == 'true' \n\nif DEBUG:\n print(\"W trybie DEBUG\")<\/code><\/pre>\n\n\n\nPrze\u0142\u0105czanie trybu debugowania wymaga tylko aktualizacji pliku .env – nie s\u0105 potrzebne zmiany w kodzie, przebudowa czy ponowne wdra\u017canie. Skr\u00f3cone \u201eEnv vars\u201d r\u00f3wnie\u017c pomagaj\u0105 w bezproblemowym wdra\u017caniu w r\u00f3\u017cnych \u015brodowiskach:<\/p>\n\n\n\n
import os\n\n# Pobierz zmienn\u0105 \u015brodowiskow\u0105, aby okre\u015bli\u0107 obecne \u015brodowisko (produkcja lub staging)\ncurrent_env = os.getenv('APP_ENV', 'staging') # Domy\u015blnie 'staging', je\u015bli nie ustawiono\n\n# Klucz API dla produkcji\nPROD_API_KEY = os.environ['PROD_API_KEY']\n\n# Klucz API dla staging\nSTG_API_KEY = os.environ['STG_API_KEY']\n\n# Logika ustawiaj\u0105ca api_key w zale\u017cno\u015bci od obecnego \u015brodowiska\nif current_env == 'production':\n api_key = PROD_API_KEY\nelse:\n api_key = STG_API_KEY\n\n# Inicjalizacja klienta API z odpowiednim kluczem API\napi = ApiClient(api_key)<\/code><\/pre>\n\n\n\nTen sam kod mo\u017ce u\u017cywa\u0107 oddzielnych kluczy API<\/a> dla produkcji vs staging bez \u017cadnych zmian.<\/p>\n\n\n\n
Na koniec, umo\u017cliwiaj\u0105 prze\u0142\u0105czanie funkcji bez nowych wdro\u017ce\u0144:<\/p>\n\n\n\n
NEW_FEATURE = os.environ['NEW_FEATURE'] == 'true'\n\nif NEW_FEATURE:\n enableNewFeature()<\/code><\/pre>\n\n\n\nZmiana zmiennej NEW_FEATURE<\/em> aktywuje funkcjonalno\u015b\u0107 natychmiast w naszym kodzie. Interfejs do aktualizacji konfiguracji zale\u017cy od system\u00f3w:<\/p>\n\n\n\n
- \n
- Platformy<\/a> Cloud u\u017cywaj\u0105 paneli internetowych<\/li>\n\n\n\n
- Serwery u\u017cywaj\u0105 narz\u0119dzi polece\u0144 systemu operacyjnego<\/li>\n\n\n\n
- Lokalne \u015brodowisko deweloperskie mo\u017ce u\u017cywa\u0107 plik\u00f3w .env<\/li>\n\n\n<\/ul>\n\n\n\n
Zmienne \u015brodowiskowe s\u0105 korzystne podczas tworzenia aplikacji, pozwalaj\u0105 u\u017cytkownikom konfigurowa\u0107 elementy zgodnie z ich wymaganiami.<\/p>\n\n\n\n
Pow\u00f3d #3: Pomagaj\u0105 Zarz\u0105dza\u0107 Tajemnicami i Po\u015bwiadczeniami<\/h3>\n\n\n\n
<\/figure>\n\n\n\nSprawdzanie sekret\u00f3w takich jak klucze API, has\u0142a i prywatne klucze bezpo\u015brednio w kodzie \u017ar\u00f3d\u0142owym stwarza znaczne ryzyko bezpiecze\u0144stwa<\/a>:<\/p>\n\n\n\n
# Unikaj ujawniania sekret\u00f3w w kodzie!\nSTRIPE_KEY = 'sk_live_1234abc'\nDB_PASSWORD = 'password123'\n\nstripe.api_key = STRIPE_KEY \ndb.connect(DB_PASSWORD)<\/code><\/pre>\n\n\n\n
- Platformy<\/a> Cloud u\u017cywaj\u0105 paneli internetowych<\/li>\n\n\n\n
- Zewn\u0119trzne<\/strong>: Warto\u015bci s\u0105 ustawiane poza kodem aplikacji za pomoc\u0105 plik\u00f3w, linii komend i system\u00f3w.<\/li>\n\n\n\n
![\"zmienne](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/02-Why-Are-Environment-Variables-Valuable.jpg\")
<\/figure>\n\n\n\n![\"pow\u00f3d](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/03-They-Separate-Application-Code-From-Configurations.jpg\")
<\/figure>\n\n\n\n![\"Aplikacja](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/04-They-Simplify-Configuring-Applications.jpg\")
<\/figure>\n\n\n\n![\"kod](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/05-They-Help-Manage-Secrets-And-Credentials.jpg\")
<\/figure>\n\n\n\n![\"konfiguracja](\"https:\/\/www.dreamhost.com\/blog\/wp-content\/uploads\/2024\/03\/06-They-Promote-Consistency.jpg\")
<\/figure>\n\n\n\n