fufu-cloud-cli 0.5.0__tar.gz → 0.6.0__tar.gz

{fufu_cloud_cli-0.5.0/src/fufu_cloud_cli.egg-info → fufu_cloud_cli-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.5.0
+Version: 0.6.0
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -77,19 +77,30 @@ FUFU credential 與 session 檔仍屬秘密，必須由作業系統和 CI 控制
 fufu capabilities
 fufu capabilities --remote --provider gcp --require cloud-run-http
 gcloud-fufu run deploy example --image approved-image:tag
+gcloud-fufu run deploy example --source ./prepared-asgi.zip --entry-point main:app
 gcloud-fufu functions deploy example-function --gen2 \
   --runtime python312 --source ./function --entry-point handler --trigger-http
 aws-fufu lambda list-functions
 ```
 
-映像需先由 FUFU 管理者準備及核准。Function 來源會上傳指定目錄中的
+自訂映像需先由 FUFU 管理者準備及核准。API 模式的 Cloud Run `--source`
+接受已封裝 Uvicorn 與相依套件的 Python 3.12 ASGI ZIP／乾淨目錄，自動離線建置、
+檢查映像並核准到目前租戶；不需要主機 SSH 或每次人工核准。
+`--entry-point module:app` 是 FUFU 擴充旗標，預設 `main:app`。
+來源上限為 ZIP 6 MiB、解壓縮 32 MiB、2000 個檔案；不接受隱藏檔、Dockerfile、
+自訂安裝設定或非空 requirements.txt。相依套件需在 CI 封裝，服務端不執行安裝 hook。
+這是固定 ASGI 配方，不提供完整 Cloud Build 或 registry API。
+成功回應包含 `build.status`、`imageDigest` 與來源包雜湊；自動核准映像
+僅供該租戶目前服務使用，取代或刪除最後一個引用後不再開放重用。
+
+Function 來源會上傳指定目錄中的
 Python 與 requirements 檔；Lambda 會上傳指定的 ZIP。請使用只含必要程式碼的
 目錄或 ZIP，先移除硬編碼秘密、個人資料與不需要的檔案。
 CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 
 | 服務 | 可用範圍與主要限制 |
 | --- | --- |
-| Cloud Run | 單一已核准 HTTP 容器；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
+| Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新；遠端 ZIP 上限 6 MiB |
 | GCS / S3 | bucket 與 object 操作子集；單一 object 上限 6 MiB，無 versioning / signed URL |

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/README.md

@@ -64,19 +64,30 @@ FUFU credential 與 session 檔仍屬秘密，必須由作業系統和 CI 控制
 fufu capabilities
 fufu capabilities --remote --provider gcp --require cloud-run-http
 gcloud-fufu run deploy example --image approved-image:tag
+gcloud-fufu run deploy example --source ./prepared-asgi.zip --entry-point main:app
 gcloud-fufu functions deploy example-function --gen2 \
   --runtime python312 --source ./function --entry-point handler --trigger-http
 aws-fufu lambda list-functions
 ```
 
-映像需先由 FUFU 管理者準備及核准。Function 來源會上傳指定目錄中的
+自訂映像需先由 FUFU 管理者準備及核准。API 模式的 Cloud Run `--source`
+接受已封裝 Uvicorn 與相依套件的 Python 3.12 ASGI ZIP／乾淨目錄，自動離線建置、
+檢查映像並核准到目前租戶；不需要主機 SSH 或每次人工核准。
+`--entry-point module:app` 是 FUFU 擴充旗標，預設 `main:app`。
+來源上限為 ZIP 6 MiB、解壓縮 32 MiB、2000 個檔案；不接受隱藏檔、Dockerfile、
+自訂安裝設定或非空 requirements.txt。相依套件需在 CI 封裝，服務端不執行安裝 hook。
+這是固定 ASGI 配方，不提供完整 Cloud Build 或 registry API。
+成功回應包含 `build.status`、`imageDigest` 與來源包雜湊；自動核准映像
+僅供該租戶目前服務使用，取代或刪除最後一個引用後不再開放重用。
+
+Function 來源會上傳指定目錄中的
 Python 與 requirements 檔；Lambda 會上傳指定的 ZIP。請使用只含必要程式碼的
 目錄或 ZIP，先移除硬編碼秘密、個人資料與不需要的檔案。
 CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 
 | 服務 | 可用範圍與主要限制 |
 | --- | --- |
-| Cloud Run | 單一已核准 HTTP 容器；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
+| Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新；遠端 ZIP 上限 6 MiB |
 | GCS / S3 | bucket 與 object 操作子集；單一 object 上限 6 MiB，無 versioning / signed URL |

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fufu-cloud-cli"
-version = "0.5.0"
+version = "0.6.0"
 description = "FUFU Cloud CLI for tenant-scoped mock cloud development and deployment"
 readme = "README.md"
 requires-python = ">=3.10"

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/src/fufu_cloud_cli/__init__.py

@@ -1,3 +1,3 @@
 """FUFU CLI 與本機部署工具；相容範圍見 capabilities.json。"""
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/src/fufu_cloud_cli/capabilities.json

@@ -11,6 +11,8 @@
       "status": "implemented",
       "operations": [
         "deploy-image",
+        "deploy-python312-asgi-source-api",
+        "automatic-tenant-image-admission",
         "replace-service-subset",
         "describe",
         "list",
@@ -19,6 +21,9 @@
       ],
       "limitations": [
         "single-approved-container",
+        "source-prepackaged-dependencies-6MiB",
+        "source-fixed-recipe-no-custom-Dockerfile",
+        "source-approval-current-tenant-services-only",
         "GCP-service-account-subset",
         "explicit-GCS-workload-helper",
         "no-registry-upload",

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/src/fufu_cloud_cli/cli.py

@@ -12,7 +12,7 @@ from .docker_backend import (Backend, FUNCTIONS_IMAGE, INGRESS_IMAGE, KINDS, LAM
                              inspect_image, prepare_runtime)
 from .errors import FufuError, require
 from .api_backend import ApiClient, api_selected, remote_command
-from .remote_compute import RemoteBackend, source_archive, lambda_archive
+from .remote_compute import RemoteBackend, source_archive, lambda_archive, cloud_run_archive
 
 
 class Parser(argparse.ArgumentParser):
@@ -204,7 +204,10 @@ def gcloud_command(argv):
     run_sub = run_p.add_subparsers(dest="action", required=True)
     d = run_sub.add_parser("deploy")
     d.add_argument("name")
-    d.add_argument("--image", required=True)
+    source = d.add_mutually_exclusive_group(required=True)
+    source.add_argument('--image')
+    source.add_argument('--source', help='已封裝相依的 Python 3.12 ASGI ZIP／目錄；API 自動建置及核准')
+    d.add_argument('--entry-point', default='main:app', help='FUFU ASGI 來源子集，預設 main:app')
     d.add_argument("--port", type=int, default=8080)
     d.add_argument('--service-account')
     deployment_options(d)
@@ -243,6 +246,13 @@ def gcloud_command(argv):
     if action == "deploy":
         manifest.name(a.name)
         env = env_from_names(a.env)
+        if a.service == 'run' and a.source:
+            require(api_selected(), 'API_BACKEND_REQUIRED', 'Cloud Run --source 自動核准需要 FUFU API 模式。')
+            return RemoteBackend(kind).deploy(kind=kind, service=a.name, env=env, port=a.port,
+                archive=cloud_run_archive(a.source), runtime='python312', handler=a.entry_point,
+                startup_timeout=a.startup_timeout, role=a.service_account)
+        if a.service == 'run':
+            require(a.entry_point == 'main:app', 'UNSUPPORTED_ARGUMENT', '--entry-point 只用於 --source。')
         if a.service == 'functions' and api_selected():
             return RemoteBackend(kind).deploy(kind=kind, service=a.name, env=env,
                 archive=source_archive(a.source), runtime=a.runtime, handler=a.entry_point, startup_timeout=a.startup_timeout, role=a.service_account)

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/src/fufu_cloud_cli/docker_backend.py

@@ -231,12 +231,12 @@ class Backend:
     def public(self, r):
         return {"name": r["name"], "kind": r["kind"], "workspace": self.workspace,
                 "revision": r["revision"], "url": self.url(r), "readiness": "tcp",
-                **{k: r[k] for k in ("runtime", "handler", "role", "sdkTransport", "iamEnforced") if k in r},
+                **{k: r[k] for k in ("runtime", "handler", "role", "sdkTransport", "iamEnforced", "build") if k in r},
                 "status": "running", "backend": "local-docker"}
 
     def deploy(self, *, kind, service, image, port=8080, env=None, command=None,
                startup_timeout=30, replace=True, require_existing=False, runtime=None, handler=None, preserve_environment=False,
-               runtime_env=None, role=None, gateway_container=None):
+               runtime_env=None, role=None, gateway_container=None, build=None):
         name(service)
         require(kind in KINDS, "UNSUPPORTED_SERVICE", "未支援此服務。")
         require(type(port) is int and 1024 <= port <= 65535, "INVALID_PORT", "無效的容器 port。")
@@ -301,7 +301,8 @@ class Backend:
                           "port": port, "revision": revision,
                           **({'network': network, 'gateway_id': gateway['id']} if gateway else {}),
                           **({'role': role, 'sdkTransport': 'fufu-workload-token', 'iamEnforced': True} if role else {}),
-                          **({"environment_names": sorted(env)} if kind != 'cloud-run-http' else {}),
+                          **({'build': build} if build else {}),
+                          "environment_names": sorted(env),
                           **({"runtime": runtime, "handler": handler} if runtime is not None else {})}
                 deadline = time.monotonic() + startup_timeout
                 while True:
@@ -576,3 +577,54 @@ def build_lambda(archive, runtime, handler):
         sdk.chmod(0o644)
         (dst / "Dockerfile").write_text(f"FROM {base}\nENV FUFU_HANDLER={handler}\nCOPY --chown=10001:10001 app/ ${{LAMBDA_TASK_ROOT}}/\nCMD " + json.dumps(["_fufu_runtime_adapter.handler"]) + "\n")
         return build_image(dst, f"fufu-cli-lambda:{uuid.uuid4().hex}")
+
+
+def build_cloud_run(archive, handler, port, tag):
+    """固定 Python ASGI 配方；不執行使用者 Dockerfile、安裝程式或建置 hook。"""
+    require(isinstance(handler, str) and re.fullmatch(r"[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)*:[A-Za-z_]\w*", handler),
+            'INVALID_HANDLER', 'ASGI entry point 必須是 module:app。')
+    require(type(port) is int and 1024 <= port <= 65535, 'INVALID_PORT', '容器 port 範圍為 1024–65535。')
+    require(re.fullmatch(r'fufu-source:[a-f0-9]{64}', tag), 'INVALID_IMAGE', '來源映像名稱無效。')
+    inspect_image(PYTHON_IMAGE)
+    base = PYTHON_IMAGE
+    with tempfile.TemporaryDirectory(prefix='fufu-asgi-') as tmp:
+        context = Path(tmp)
+        app = context / 'app'
+        app.mkdir()
+        # Validate before extraction to bound disk use and reject silent build omissions.
+        try:
+            with zipfile.ZipFile(archive) as z:
+                entries = z.infolist()
+                require(len(entries) <= 2000 and sum(i.file_size for i in entries) <= 32 * 1024**2,
+                        'SOURCE_LIMIT', 'ASGI 來源上限為 2000 個檔案、解壓縮後 32 MiB。')
+                require(all(not any(v.startswith('.') or v in {'__pycache__', 'node_modules'}
+                                    for v in PurePosixPath(i.filename).parts) for i in entries),
+                        'UNSUPPORTED_SOURCE', 'ASGI 來源包不可包含隱藏檔或開發快取。')
+                require(not {'Dockerfile', 'docker-compose.yml', 'compose.yaml', 'Procfile', 'pyproject.toml', 'setup.py'}.intersection(z.namelist()),
+                        'UNSUPPORTED_SOURCE', '來源部署使用固定 ASGI 配方；不接受自訂 Dockerfile、安裝或啟動設定。')
+        except (zipfile.BadZipFile, OSError):
+            raise FufuError('INVALID_ZIP', '來源必須是有效的 ZIP。') from None
+        extract_zip(Path(archive), app)
+        module = handler.split(':')[0].replace('.', '/')
+        require((app / (module + '.py')).is_file() or (app / module / '__init__.py').is_file(),
+                'INVALID_HANDLER', '來源包缺少指定 ASGI 模組。')
+        require((app / 'uvicorn/__main__.py').is_file(), 'DEPENDENCIES_NOT_PREPARED', '請將 Uvicorn 與所有 Linux Python 3.12 相依套件打入來源包。')
+        requirements = app / 'requirements.txt'
+        require(not requirements.exists() or not requirements.read_text().strip(),
+                'DEPENDENCIES_NOT_PREPARED', '來源模式不執行 requirements.txt；請先封裝相依套件。')
+        sdk = app / '_fufu_runtime_sdk.py'
+        require(not sdk.exists(), 'RESERVED_FILE', '來源與 FUFU SDK 保留檔名衝突。')
+        shutil.copyfile(Path(__file__).with_name('runtime_sdk.py'), sdk)
+        sdk.chmod(0o644)
+        command = ['python', '-m', 'uvicorn', handler, '--host', '0.0.0.0', '--port', str(port)]
+        (context / 'Dockerfile').write_text(
+            f'FROM {base}\nCOPY --chown=10001:10001 app/ /app/\nWORKDIR /app\n'
+            'ENV PYTHONDONTWRITEBYTECODE=1 PYTHONUNBUFFERED=1\nUSER 10001:10001\n'
+            'CMD ' + json.dumps(command) + '\n')
+        digest = build_image(context, tag, network='none')
+        policy = object_json(docker('image', 'inspect', digest, '--format',
+            '{"user":{{json .Config.User}},"size":{{json .Size}},"volumes":{{json .Config.Volumes}},"cmd":{{json .Config.Cmd}}}'))
+        require(policy.get('user') == '10001:10001' and type(policy.get('size')) is int
+                and 0 < policy['size'] <= 512 * 1024**2 and not policy.get('volumes') and policy.get('cmd') == command,
+                'IMAGE_POLICY_REJECTED', '建置映像未通過執行身分、大小或啟動設定檢查。')
+        return digest

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0}/src/fufu_cloud_cli/remote_compute.py

@@ -43,6 +43,33 @@ def lambda_archive(path):
     return base64.b64encode(p.read_bytes()).decode()
 
 
+def cloud_run_archive(source):
+    """Upload an explicitly prepared ZIP or directory, without dependency execution."""
+    root = Path(source)
+    require(not root.is_symlink(), 'INVALID_SOURCE', '來源不可為符號連結。')
+    if root.is_file():
+        return lambda_archive(root)
+    require(root.is_dir(), 'INVALID_SOURCE', '請指定已封裝相依套件的 ASGI ZIP 或目錄。')
+    data = io.BytesIO()
+    total = count = 0
+    with zipfile.ZipFile(data, 'w', zipfile.ZIP_DEFLATED) as archive:
+        for path in sorted(root.rglob('*')):
+            relative = path.relative_to(root)
+            require(not path.is_symlink(), 'INVALID_SOURCE', '來源不可含符號連結。')
+            require(not any(v.startswith('.') or v in {'__pycache__', 'node_modules'} for v in relative.parts),
+                    'UNSUPPORTED_SOURCE', '請使用只含應用及相依套件的目錄，不可含隱藏檔或快取。')
+            if path.is_dir():
+                continue
+            require(path.is_file(), 'INVALID_SOURCE', '來源只接受一般檔案。')
+            total += path.stat().st_size
+            count += 1
+            require(count <= 2000 and total <= 32 * 1024**2, 'SOURCE_LIMIT', 'ASGI 來源超過上限。')
+            archive.write(path, relative.as_posix())
+            require(data.tell() <= MAX_ARCHIVE, 'SOURCE_LIMIT', '遠端 ASGI ZIP 上限為 6 MiB。')
+    require(0 < data.tell() <= MAX_ARCHIVE, 'SOURCE_LIMIT', '遠端 ASGI ZIP 上限為 6 MiB。')
+    return base64.b64encode(data.getvalue()).decode()
+
+
 class RemoteBackend:
     def __init__(self, kind):
         require(kind in KIND_PROVIDER, "CAPABILITY_NOT_SUPPORTED", "此類型尚無遠端 compute。")

{fufu_cloud_cli-0.5.0 → fufu_cloud_cli-0.6.0/src/fufu_cloud_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.5.0
+Version: 0.6.0
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -77,19 +77,30 @@ FUFU credential 與 session 檔仍屬秘密，必須由作業系統和 CI 控制
 fufu capabilities
 fufu capabilities --remote --provider gcp --require cloud-run-http
 gcloud-fufu run deploy example --image approved-image:tag
+gcloud-fufu run deploy example --source ./prepared-asgi.zip --entry-point main:app
 gcloud-fufu functions deploy example-function --gen2 \
   --runtime python312 --source ./function --entry-point handler --trigger-http
 aws-fufu lambda list-functions
 ```
 
-映像需先由 FUFU 管理者準備及核准。Function 來源會上傳指定目錄中的
+自訂映像需先由 FUFU 管理者準備及核准。API 模式的 Cloud Run `--source`
+接受已封裝 Uvicorn 與相依套件的 Python 3.12 ASGI ZIP／乾淨目錄，自動離線建置、
+檢查映像並核准到目前租戶；不需要主機 SSH 或每次人工核准。
+`--entry-point module:app` 是 FUFU 擴充旗標，預設 `main:app`。
+來源上限為 ZIP 6 MiB、解壓縮 32 MiB、2000 個檔案；不接受隱藏檔、Dockerfile、
+自訂安裝設定或非空 requirements.txt。相依套件需在 CI 封裝，服務端不執行安裝 hook。
+這是固定 ASGI 配方，不提供完整 Cloud Build 或 registry API。
+成功回應包含 `build.status`、`imageDigest` 與來源包雜湊；自動核准映像
+僅供該租戶目前服務使用，取代或刪除最後一個引用後不再開放重用。
+
+Function 來源會上傳指定目錄中的
 Python 與 requirements 檔；Lambda 會上傳指定的 ZIP。請使用只含必要程式碼的
 目錄或 ZIP，先移除硬編碼秘密、個人資料與不需要的檔案。
 CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 
 | 服務 | 可用範圍與主要限制 |
 | --- | --- |
-| Cloud Run | 單一已核准 HTTP 容器；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
+| Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；無 autoscaling、traffic splitting、Jobs 或公開 ingress |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
 | AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新；遠端 ZIP 上限 6 MiB |
 | GCS / S3 | bucket 與 object 操作子集；單一 object 上限 6 MiB，無 versioning / signed URL |