Python: Wdrażanie do produkcji

Jak wdrożyć swój kod Python do produkcji w kilka minut

👋 Witamy w dokumentacji Stackhero!

Stackhero oferuje gotowe do użycia rozwiązanie Python cloud, które zapewnia wiele korzyści, w tym:

Wdrażaj swoją aplikację w kilka sekund za pomocą prostego git push.

Używaj własnej nazwy domeny i korzystaj z automatycznej konfiguracji certyfikatów HTTPS dla zwiększonego bezpieczeństwa.

Ciesz się spokojem dzięki automatycznym kopiom zapasowym, aktualizacjom jednym kliknięciem oraz prostemu, przejrzystemu i przewidywalnemu cennikowi.

Uzyskaj optymalną wydajność i solidne zabezpieczenia dzięki prywatnej i dedykowanej VM.

Oszczędzaj czas i upraszczaj sobie życie: wypróbowanie rozwiązania Python cloud hosting Stackhero zajmuje tylko 5 minut!

Usługa hostingu w chmurze Python od Stackhero oferuje prosty i niezawodny sposób na wdrożenie projektów Python do środowiska produkcyjnego w zaledwie kilka minut. Dzięki intuicyjnej konfiguracji i zaawansowanym funkcjom możesz skupić się na budowie swojej aplikacji, podczas gdy Stackhero zajmuje się szczegółami infrastruktury.

Najważniejsze funkcje to:

Wdrażanie za pomocą prostego polecenia git push
Własne domeny z automatycznym zarządzaniem certyfikatami TLS (HTTPS)
Dedykowane, prywatne maszyny wirtualne (VM) dla zwiększonego bezpieczeństwa i poufności
Obsługa HTTP/2, TLS 1.3 (HTTPS), WebSockets, kompresji GZIP & Brotli, ETag oraz dostęp do portów TCP/UDP

Wymagania wstępne

Przed rozpoczęciem pracy ze Stackhero upewnij się, że na Twoim komputerze jest zainstalowany Git.

Jeśli Twoje środowisko deweloperskie nie jest jeszcze skonfigurowane lub chcesz zaoszczędzić czas na konfiguracji, możesz wypróbować Code-Hero od Stackhero.

Code-Hero to łatwa w użyciu, gotowa do pracy platforma deweloperska, która działa bezpośrednio w przeglądarce – na dowolnym komputerze, tablecie lub telefonie. Bazując na forku VSCode, Code-Hero jest wyposażony we wszystkie niezbędne narzędzia programistyczne, dzięki czemu możesz zacząć kodować od razu, bez dodatkowej konfiguracji.

Przykład instancji Code-Hero uruchomionej bezpośrednio w przeglądarce

Kroki wdrożenia na Stackhero

Wdrażanie aplikacji Python na Stackhero zostało zaprojektowane tak, aby było proste i bezproblemowe. Oto jak to zrobić:

Utwórz usługę Python na Stackhero.
Dodaj swój klucz publiczny SSH do konfiguracji usługi Python.
Skonfiguruj polecenie git push na swojej platformie deweloperskiej.
Dodaj plik Makefile do swojego projektu.
Wdróż swój kod do produkcji.

Jeśli napotkasz jakiekolwiek problemy podczas wdrażania, odpowiedzi najprawdopodobniej znajdziesz w dokumentacji "Rozwiązywanie problemów". Sprawdzenie jej w pierwszej kolejności pozwoli Ci uniknąć niepotrzebnej frustracji.

Konfiguracja usługi "Stackhero for Python"

Jeśli nie uruchomiłeś jeszcze usługi Stackhero for Python, możesz ją utworzyć z poziomu swojego panelu Stackhero. Zazwyczaj zajmuje to tylko kilka minut.

Gdy Twoja usługa Python będzie już aktywna, musisz dodać swój klucz publiczny SSH do jej konfiguracji. Aby wyświetlić swój klucz publiczny, uruchom:

cat ~/.ssh/id_*.pub

Nie masz jeszcze kluczy SSH?

Możesz je wygenerować poleceniem:
ssh-keygen -t ed25519

Aby dodać swój klucz publiczny do usługi Python:

Otwórz panel Stackhero i wybierz swoją usługę Python.
Kliknij przycisk "Configure".
Wklej swój klucz publiczny SSH w sekcji "SSH public keys".

Przykład konfiguracji usługi Python

Wskazówka: Możesz również ustawić swój klucz publiczny SSH globalnie, aby każda nowa usługa automatycznie go zawierała. W tym celu przejdź do swojego profilu w panelu Stackhero, kliknij swoje zdjęcie profilowe w prawym górnym rogu, wybierz "Your profile" i dodaj swój klucz publiczny SSH.

Konfiguracja polecenia `git push` do wdrożenia

Stackhero upraszcza wdrożenia dzięki wykorzystaniu CLI Git i znanego polecenia git push. Nie musisz instalować dodatkowego oprogramowania – wystarczy raz skonfigurować zdalne repozytorium Git i możesz działać.

Polecenie git remote command znajdziesz na głównej stronie swojej usługi w panelu Stackhero. Będzie wyglądać mniej więcej tak:

git remote add stackhero ssh://stackhero@<XXXXXX>.stackhero-network.com:222/project.git

Polecenie Git remote Python w panelu Stackhero

Tworzenie Makefile do wdrożenia na Stackhero

Aby poinformować Stackhero, jak uruchomić Twoją aplikację, użyjesz pliku Makefile w katalogu głównym projektu.

Jeśli nie miałeś jeszcze do czynienia z plikami Makefile i poleceniem make, nie martw się. Po prostu postępuj zgodnie z poniższymi instrukcjami.

Utwórz plik Makefile w katalogu głównym projektu z następującą zawartością:

run:
	gunicorn app:app -b 0.0.0.0:8080 --error-logfile -

Kilka ważnych kwestii dotyczących tego Makefile:

Reguła run jest wymagana, ponieważ Stackhero uruchamia ją automatycznie. Prosimy jej nie zmieniać.
Polecenie gunicorn app:app -b 0.0.0.0:8080 --error-logfile - to tylko przykład. Dostosuj je do wymagań swojej aplikacji.
Upewnij się, że polecenie gunicorn zaczyna się od znaku tabulacji. Jeśli pojawi się błąd typu "*** missing separator", oznacza to brak tabulacji.

W tym przykładzie Gunicorn służy do uruchomienia Twojej aplikacji (upewnij się, że znajduje się w pliku requirements.txt). Argument -b 0.0.0.0:8080 oznacza nasłuchiwanie na wszystkich interfejsach na porcie 8080. Jeśli wybierzesz inny port, pamiętaj o aktualizacji konfiguracji usługi Python w panelu Stackhero. Fragment app:app odnosi się do obiektu app w pliku app.py.

Wdrażanie aplikacji Python

Gdy wszystko jest już skonfigurowane, możesz przystąpić do wdrożenia. W katalogu projektu użyj poniższego polecenia, aby przesłać kod na Stackhero:

git push stackhero main

Przy pierwszym uruchomieniu tego polecenia zostaniesz poproszony o potwierdzenie odcisku klucza SSH. Po prostu odpowiedz "yes", gdy zostaniesz o to zapytany. Po kilku sekundach Twoja aplikacja będzie dostępna online.

Przykład wdrożenia kodu Python na Stackhero za pomocą polecenia git push

Aby zobaczyć wdrożoną aplikację, przejdź do adresu URL "website" podanego w panelu Stackhero (zwykle wygląda jak https://<XXXXXX>.stackhero-network.com).

To wszystko – Twoja aplikacja działa już w środowisku produkcyjnym.

Masz problemy podczas wdrożenia?

Sekcja Rozwiązywanie problemów zawiera wiele rozwiązań, które pomogą Ci szybko uporać się z napotkanymi trudnościami.

Podsumowanie

Mamy nadzieję, że ten przewodnik sprawił, że wdrażanie kodu Python do produkcji na Stackhero jest dla Ciebie jasne i przystępne. Dzięki tej podstawie możesz niezawodnie uruchamiać swoje projekty online.

Jeśli chcesz pójść o krok dalej, dokumentacja "Zaawansowane scenariusze wdrożenia" obejmuje tematy takie jak wdrażanie z różnych gałęzi, tagów lub commitów git, zarządzanie wieloma środowiskami (np. staging i produkcja) oraz korzystanie ze zmiennych środowiskowych.

Pamiętaj też, że jeśli napotkasz jakiekolwiek problemy, dokumentacja "Rozwiązywanie problemów" jest zawsze dostępna, aby pomóc Ci szybko wrócić na właściwe tory.