Zależności dla funkcji w Cloud Functions zapisanych w języku Python można określić na 2 sposoby: 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 za pomocą standardu Pipfile/Pipfile.lock nie jest obsługiwana. Twój 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.
Ten plik musi znajdować się w tym samym katalogu co plik main.py, który zawiera kod funkcji.
Gdy wdrażasz lub ponownie wdrażasz swoją funkcję, Cloud Functions używa pip do pobrania i zainstalowania najnowszej wersji zależności zgodnie z zadeklarowanymi w pliku requirements.txt.
Plik requirements.txt zawiera po jednym wierszu na pakiet. Każdy wiersz zawiera nazwę pakietu i opcjonalnie żądaną wersję. Więcej informacji znajdziesz w dokumentacji requirements.txt.
Aby zapobiec wpływowi zmian wersji zależności na kompilację, możesz przypiąć pakiety 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ż Cloud Functions instaluje ją w Twoim imieniu podczas tworzenia, zalecamy dodanie jej jako wyraźnej zależności, aby była bardziej zrozumiała.
Jeśli działanie funkcji zależy od zależności prywatnych, zalecamy utworzenie odzwierciedlenia pliku functions-framework w rejestrze prywatnym. Aby uniknąć instalowania pakietu z publicznego internetu, dodaj zduplikowany plik functions-framework jako zależność od swojej funkcji.
Pakowanie zależności lokalnych
Możesz też spakować i wdrażać zależności razem z funkcją. Ta metoda jest przydatna, jeśli 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ć struktury katalogów takiej:
myfunction/
├── main.py
└── localpackage/
├── __init__.py
└── script.py
Następnie możesz w zwykły sposób zaimportować kod z usługi localpackage, korzystając z następującej instrukcji 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 można nadal połączyć w pakietach, ale mogą nie działać prawidłowo w Cloud Functions.