Xử lý các phần phụ thuộc


Có hai cách để chỉ định các phần phụ thuộc cho Cloud Functions được viết bằng Python: sử dụng tệp pip của trình quản lý gói requirements.txt hoặc đóng gói các phần phụ thuộc cục bộ cùng với hàm.

Không hỗ trợ thông số kỹ thuật phần phụ thuộc bằng tiêu chuẩn Pipfile/Pipfile.lock. Dự án của bạn không được chứa các tệp này.

Chỉ định các phần phụ thuộc bằng pip

Các phần phụ thuộc trong Python được quản lý bằng pip và được biểu thị trong một tệp siêu dữ liệu có tên là requirements.txt. Tệp này phải nằm trong cùng thư mục với tệp main.py chứa mã hàm của bạn.

Khi bạn triển khai hoặc triển khai lại hàm, Cloud Functions sẽ sử dụng pip để tải xuống và cài đặt phiên bản mới nhất của các phần phụ thuộc như được khai báo trong tệp requirements.txt. Tệp requirements.txt chứa một dòng cho mỗi gói. Mỗi dòng chứa tên gói và tuỳ chọn là phiên bản được yêu cầu. Để biết thêm thông tin chi tiết, hãy xem tài liệu tham khảo.requirements.txt

Để ngăn bản dựng bị ảnh hưởng bởi các thay đổi về phiên bản phần phụ thuộc, hãy cân nhắc ghim các gói phần phụ thuộc vào một phiên bản cụ thể.

Sau đây là ví dụ về tệp requirements.txt:

functions-framework
requests==2.20.0
numpy

Đóng gói các phần phụ thuộc cục bộ

Bạn cũng có thể đóng gói và triển khai các phần phụ thuộc cùng với hàm. Phương pháp này hữu ích nếu phần phụ thuộc của bạn không có sẵn thông qua trình quản lý gói pip hoặc nếu quyền truy cập Internet của môi trường Cloud Functions bị hạn chế.

Ví dụ: bạn có thể sử dụng cấu trúc thư mục như sau:

myfunction/
├── main.py
└── localpackage/
    ├── __init__.py
    └── script.py

Sau đó, bạn có thể nhập mã như bình thường từ localpackage bằng câu lệnh import sau.

# Code in main.py
from localpackage import script

Xin lưu ý rằng phương pháp này sẽ không chạy bất kỳ tệp setup.py nào. Các gói có những tệp đó vẫn có thể được gói, nhưng có thể không chạy đúng cách trên Cloud Functions.