Docker: Konfiguracja zmiennych środowiskowych i sekretów

Ta dokumentacja jest częścią przewodnika Wdrażanie za pomocą GitHub Actions. Pełny przewodnik znajdziesz tutaj: Dowiedz się, jak wdrażać kontenery Docker przy użyciu GitHub Actions.

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje gotowe do użycia rozwiązanie Docker cloud CaaS (Containers as a Service), które zapewnia wiele korzyści, w tym:

• Łatwe wdrażanie kontenerów do produkcji za pomocą prostego docker-compose up.
• Dostosowywana nazwa domeny zabezpieczona HTTPS (na przykład, https://api.twoja-firma.com, https://www.twoja-firma.com, https://backoffice.twoja-firma.com).
• Optymalna wydajność i solidne zabezpieczenia dzięki prywatnej i dedykowanej VM.
• Bezproblemowe aktualizacje za pomocą jednego kliknięcia.

Oszczędzaj czas i upraszczaj swoje życie: wystarczy 5 minut, aby wypróbować rozwiązanie Docker CaaS cloud hosting Stackhero i wdrożyć swoje kontenery do produkcji!

Pobierz nazwę domeny i hasło do certyfikatów

Aby GitHub Actions mogło połączyć się z Twoją usługą Docker na Stackhero, będziesz potrzebować dwóch informacji: nazwy domeny Twojej usługi oraz hasła do certyfikatów.

1. W panelu Stackhero wybierz swoją usługę Docker "production" i kliknij przycisk "Configure".

   Pobierz ustawienia usługi

2. Skopiuj zarówno "Domain name", jak i "Docker certificates password" – będą potrzebne w kolejnych krokach.

   Pobierz ustawienia usługi

Ustaw nazwę domeny i hasło do certyfikatów w GitHub

1. W GitHub otwórz swój projekt.

2. Przejdź do Settings > Environments, a następnie kliknij New environment.

   Konfiguracja środowisk GitHub

3. W polu Name wpisz "production" i zatwierdź.

   Ustawianie środowiska

4. Kliknij przycisk No restriction i wybierz Selected branches and tags.

   Ustawianie ograniczeń środowiska

5. Kliknij Add deployment branch or tag rule, wpisz "production" w polu Name pattern i kliknij Add rule.

   Ustawianie gałęzi środowiska Ustawianie gałęzi środowiska

6. W sekcji Environment secrets kliknij Add secret.

   Dodawanie sekretu

7. Jako nazwę sekretu użyj STACKHERO_CERTIFICATES_PASSWORD i wklej swoje hasło do certyfikatów w pole Value.

   Ustawianie sekretu z hasłem do certyfikatów

8. W sekcji Environment variables kliknij Add variable.

   Ustawianie zmiennych

9. Jako nazwę użyj STACKHERO_ENDPOINT i wklej endpoint swojej usługi Docker w pole Value. Endpoint znajdziesz w panelu Stackhero.

   Ustawianie zmiennej endpoint

Jeśli spersonalizowałeś nazwę domeny swojej usługi, pamiętaj, aby użyć własnej domeny zamiast <XXXXXX>.stackhero-network.com.

Dostosowanie pliku konfiguracyjnego Docker Compose

Jeśli plik docker-compose.yml znajduje się już w katalogu głównym projektu i nie wymaga modyfikacji, możesz pominąć tę sekcję.

Domyślnie GitHub Actions szuka pliku docker-compose.yml w katalogu głównym projektu. Jeśli chcesz użyć innego pliku lub konfiguracji, możesz dostosować polecenie wdrożenia. Na przykład, jeśli korzystasz z naszego boilerplate Node.js i Docker na start, możesz utworzyć nową zmienną środowiskową o nazwie STACKHERO_DEPLOY_COMMAND i ustawić ją na:

docker compose --env-file env.list --file docker/docker-compose.yml --file docker/docker-compose.production.yml up --build --remove-orphans -d