Zmienne środowiskowe Docker Compose (samouczek dla programistów)

Czym jest Docker?

Docker to system typu open source, który ułatwia tworzenie, wdrażanie i uruchamianie aplikacji w systemie poprzez konteneryzację. Kontenery to ultralekkie, przenośne jednostki zawierające zarówno aplikację, jak i jej zależności, dzięki czemu działają one jednakowo wszędzie — od komputera programisty po serwery produkcyjne. W porównaniu z tradycyjnymi maszynami wirtualnymi kontenery współdzielą jądro systemu operacyjnego hosta, dzięki czemu są znacznie szybsze i wydajniejsze.

Oznaczałoby to wirtualizowany szablon w postaci obrazów Docker do tworzenia i utrzymywania tego zestawu kontenerów. Ponadto platforma zawiera Docker Hub, który jest w pewnym sensie repozytorium obrazów kontenerów. Piękno tej technologii polega na jej łatwości użytkowania w zakresie skalowalności, przenośności i wydajności, co jest jednym z powodów, dla których zyskała ona taką popularność wśród wielu środowisk DevOps i procesów programistycznych opartych na chmurze.

Czym są zmienne środowiskowe w Docker-Compose?

W Dockerze do konfiguracji ustawień w aplikacji kontenerowej używana jest zmienna środowiskowa w postaci pary klucz-wartość. Takie zmienne mogą być przydatne do kontrolowania zachowania samej aplikacji bez modyfikowania jej kodu, ponieważ można łatwo zmieniać konfiguracje, takie jak poświadczenia bazy danych i klucze API lub tryby środowiska (na przykład: programowanie, produkcja).

W Dockerze atrybut środowiska można zdefiniować w pliku Dockerfile, w pliku docker-compose.yml lub przekazać w czasie wykonywania za pomocą polecenia docker run. Dzięki wykorzystaniu zmiennych środowiskowych Docker umożliwia spójne i elastyczne wdrażanie aplikacji w różnych środowiskach oraz pozwala na bardziej efektywne zarządzanie danymi wrażliwymi, takimi jak hasła i tokeny API.

Jak utworzyć zmienne środowiskowe w Dockerze?

# Dockerfile
# Set the application environment
ENV APP_ENV=development
# Set the database URL
ENV DATABASE_URL=postgres://user:password@db:1234/mydev

version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev

version: '3.8'
services:
  myapp:
    image: myapp:latest
    environment:
      - APP_ENV=development
      - DATABASE_URL=postgres://user:password@db:1234/mydev

docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev myapp:latest

docker run -e APP_ENV=development -e DATABASE_URL=postgres://user:password@db:1234/mydev myapp:latest

# .env file
APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev

# .env file
APP_ENV=production
DATABASE_URL=postgres://user:password@db:1234/mydev

Czym jest IronSecureDoc?

IronSecureDoc dla Docker pozwala programistom w łatwy sposób dodać funkcję bezpiecznego przetwarzania dokumentów do swoich aplikacji kontenerowych. Po opanowaniu Docker możesz zamknąć swoją aplikację ASP.NET Core w IronSecureDoc w jednolitym środowisku, które ułatwia wdrażanie i skalowanie. W tym celu należy utworzyć plik Dockerfile, który koordynuje tworzenie aplikacji ASP.NET Core przy użyciu biblioteki IronSecureDoc oraz ewentualnie innych skryptów instalacyjnych lub konfiguracji niezbędnych do prawidłowego działania.

Ponadto zawiera plik docker-compose.yml, w którym zadeklarowano zależności usług, zmienne środowiskowe oraz zmapowane porty, z których należy korzystać. Dzięki temu wykonywanie zadań związanych z bezpieczeństwem dokumentów staje się znacznie łatwiejsze, co pozwala na wydajne i skuteczne działanie aplikacji w środowisku innym niż to używane podczas tworzenia lub produkcji. Instalacja i konfiguracja IronSecureDoc Podobnie jak w przypadku Docker, aby w pełni wykorzystać możliwości IronSecureDoc, konieczna będzie jego prawidłowa instalacja i konfiguracja: szyfrowanie dokumentów, redagowanie itp.

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:8080/v1/document-services/pdfs/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Wnioski

Podsumowując, zmienne środowiskowe Docker Compose umożliwiają konfigurację aplikacji w bardzo elastyczny i wydajny sposób, ponieważ szczegóły konfiguracji są automatycznie oddzielone od kodu aplikacji. W rezultacie zarządzanie różnymi środowiskami, takimi jak środowisko programistyczne, testowe i produkcyjne, jest prostsze, ponieważ zamiast kodu aplikacji wystarczy zmienić jedynie zmienne, takie jak klucze API, dane uwierzytelniające do bazy danych oraz ustawienia aplikacji.

Wykorzystanie Docker Compose do wdrożenia IronSecureDoc wykorzystuje zmienne środowiskowe do bezpiecznego przetwarzania informacji licencyjnych, na przykład IronSecureDoc_LicenseKey, a także do określenia portów HTTP lub preferowanego trybu środowiska (rozwojowego lub produkcyjnego) za pomocą zmiennych środowiskowych. Wykorzystanie zmiennych środowiskowych do konfiguracji ułatwia wdrożenie IronSecureDoc, zmniejszając liczbę nieuporządkowanych i trudnych do skalowania ustawień oraz zwiększając bezpieczeństwo.

Zaawansowane funkcje stają się dostępne dzięki ważnej licencji IronSecureDoc. Korzystanie z narzędzia jest ściśle uzależnione od określonych warunków użytkowania. Można również skorzystać z innych wysokowydajnych bibliotek oferowanych przez Iron Software, aby ułatwić i przyspieszyć proces tworzenia oprogramowania, zapewniając solidne funkcje do pracy z plikami PDF, rozpoznawania tekstu i BarCode dla każdej możliwej aplikacji.