Istnieją 2 sposoby określenia zależności dla zadania Cloud Functions zapisanego w Pythonie: możesz użyć pliku requirements.txt menedżera pakietów pip lub spakować lokalne zależności razem z funkcją.
Specyfikacja zależności korzystająca ze standardu Pipfile/Pipfile.lock nie jest obsługiwana. Projekt nie powinien zawierać tych plików.
Określanie zależności za pomocą pip
Zarządzanie zależnościami w Pythonie jest zarządzane za pomocą pipa i wyrażane w pliku metadanych o nazwie requirements.txt.
Plik ten musi znajdować się w tym samym katalogu co plik main.py zawierający kod funkcji.
Podczas wdrażania lub ponownego wdrażania funkcji usługa Cloud Functions używa pip do pobrania i zainstalowania najnowszej wersji zależności zgodnie z deklaracją w pliku requirements.txt.
Plik requirements.txt zawiera po 1 wierszu na pakiet. Każdy wiersz zawiera nazwę pakietu i opcjonalnie żądaną wersję. Więcej informacji znajdziesz w dokumentacji requirements.txt.
Aby zmiany wersji zależności nie wpływały na kompilację, rozważ przypięcie pakietów zależności do określonej wersji.
Oto przykładowy plik requirements.txt:
functions-framework requests==2.20.0 numpy
Platforma funkcji jest wymagana w przypadku wszystkich funkcji. Chociaż usługa Cloud Functions instaluje ją w Twoim imieniu podczas tworzenia funkcji, zalecamy dodanie jej jako wyraźnej zależności, aby zwiększyć przejrzystość.
Jeśli działanie funkcji zależy od zależności prywatnych, zalecamy utworzenie odzwierciedlenia pliku functions-framework w rejestrze prywatnym. Dodaj zwierciadło functions-framework jako zależność funkcji, aby uniknąć instalowania pakietu z publicznego internetu.
Pakowanie zależności lokalnych
Możesz też spakować i wdrażać zależności razem z funkcją. Jest to przydatne, jeśli Twoja zależność nie jest dostępna w menedżerze pakietów pip lub jeśli dostęp do internetu w środowisku Cloud Functions jest ograniczony.
Możesz na przykład użyć takiej struktury katalogu:
myfunction/
├── main.py
└── localpackage/
├── __init__.py
└── script.py
Następnie możesz zaimportować kod jak zwykle z poziomu localpackage, używając tego polecenia import.
# Code in main.py from localpackage import script
Pamiętaj, że ta metoda nie uruchomi żadnych plików setup.py. Pakiety z tymi plikami nadal można łączyć, ale mogą one nie działać prawidłowo na urządzeniu Cloud Functions.