fufu-cloud-cli 0.11.0__tar.gz → 0.11.1__tar.gz

{fufu_cloud_cli-0.11.0/src/fufu_cloud_cli.egg-info → fufu_cloud_cli-0.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.11.0
+Version: 0.11.1
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -29,7 +29,7 @@ Dynamic: license-file
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
 0.11.0 新增獨占 GPU VM 的租用命令。需由平台啟用並驗證對應實體節點；
-支援的 RTX 3060 為整卡直通至 KVM 客體，可執行 NVIDIA 驅動與 CUDA。
+支援的 RTX 3060 以專用 GPU 提供給 VM，可執行 NVIDIA 驅動與 CUDA。
 停止 VM 仍保留整卡，刪除後才釋放。GPU 使用中或已保留會明確拒絕，
 不會自動中斷其他工作。CLI 不包含節點 SSH 金鑰、主機裝置管理程式或平台設定。
 
@@ -54,8 +54,8 @@ S3 bucket tags。需配套 FUFU API；不支援 bucket versioning、retention、
 KMS、bucket IAM、GCS bucket labels 或 force destroy。
 
 0.10.0 新增 Compute Engine／EC2 VM 與 GKE／EKS 介面的實際運算命令。
-需要啟用相應 infrastructure backend 的 FUFU 服務端；VM 使用 KVM／KubeVirt，
-叢集使用獨立 Kubernetes API 與共用節點，均不是官方雲端資源。
+需要啟用相應功能的 FUFU 服務端；提供實際 VM 與獨立 Kubernetes API，
+叢集使用共用運算資源，均不是官方雲端資源。
 支援 VM 建立、SSH 指令、停止／啟動與刪除，以及叢集建立、查詢、
 get-credentials／update-kubeconfig、waiter 與刪除。
 取得憑證後可使用標準 kubectl 部署 Deployment、Service、Job 及受管 GPU 容器。
@@ -145,7 +145,7 @@ BigQuery 是 tenant emulator 的 GoogleSQL 子集，無 DML／DDL、load/export
 
 0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
 
-0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離環境驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1}/README.md

@@ -5,7 +5,7 @@
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
 0.11.0 新增獨占 GPU VM 的租用命令。需由平台啟用並驗證對應實體節點；
-支援的 RTX 3060 為整卡直通至 KVM 客體，可執行 NVIDIA 驅動與 CUDA。
+支援的 RTX 3060 以專用 GPU 提供給 VM，可執行 NVIDIA 驅動與 CUDA。
 停止 VM 仍保留整卡，刪除後才釋放。GPU 使用中或已保留會明確拒絕，
 不會自動中斷其他工作。CLI 不包含節點 SSH 金鑰、主機裝置管理程式或平台設定。
 
@@ -30,8 +30,8 @@ S3 bucket tags。需配套 FUFU API；不支援 bucket versioning、retention、
 KMS、bucket IAM、GCS bucket labels 或 force destroy。
 
 0.10.0 新增 Compute Engine／EC2 VM 與 GKE／EKS 介面的實際運算命令。
-需要啟用相應 infrastructure backend 的 FUFU 服務端；VM 使用 KVM／KubeVirt，
-叢集使用獨立 Kubernetes API 與共用節點，均不是官方雲端資源。
+需要啟用相應功能的 FUFU 服務端；提供實際 VM 與獨立 Kubernetes API，
+叢集使用共用運算資源，均不是官方雲端資源。
 支援 VM 建立、SSH 指令、停止／啟動與刪除，以及叢集建立、查詢、
 get-credentials／update-kubeconfig、waiter 與刪除。
 取得憑證後可使用標準 kubectl 部署 Deployment、Service、Job 及受管 GPU 容器。
@@ -121,7 +121,7 @@ BigQuery 是 tenant emulator 的 GoogleSQL 子集，無 DML／DDL、load/export
 
 0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
 
-0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離環境驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1}/pyproject.toml

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

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1}/src/fufu_cloud_cli/__init__.py

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

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1}/src/fufu_cloud_cli/capabilities.json

@@ -365,7 +365,7 @@
       "limitations": [
         "single-host-configurable-storage-capacity-default-2GiB-per-tenant",
         "default-30-day-log-retention",
-        "bounded-durable-spool-and-Docker-log-rotation",
+        "bounded-durable-spool-and-log-rotation",
         "no-sinks-alerts-or-native-Monitoring-Trace-API",
         "no-new-IaC-resources"
       ]
@@ -547,7 +547,7 @@
         "create-list-describe-delete", "stop-start", "guest-ssh-command", "exclusive-gpu-vm"
       ],
       "limitations": ["requires-FUFU-infrastructure-backend", "Debian-12-only", "private-network", "single-node-disk", "GPU-requires-enabled-validated-node", "GPU-exclusive-until-delete", "no-GPU-hotplug-or-live-migration", "no-official-IaC-provider"],
-      "reason": "實際 KVM／KubeVirt VM、持久磁碟與 SSH 指令；原生風格指令子集，無官方雲端資源。"
+      "reason": "實際 VM、持久磁碟與 SSH 指令；原生風格指令子集，無官方雲端資源。"
     },
     "gcp-gke": {
       "name": "GKE",
@@ -556,7 +556,7 @@
       "mode": "simplified",
       "operations": ["create-list-describe-delete", "get-credentials", "kubectl-workloads", "GPU-container-jobs"],
       "limitations": ["requires-FUFU-infrastructure-backend", "shared-workers", "single-control-plane-replica", "no-workload-PVC", "no-public-LoadBalancer", "no-interactive-exec-or-portforward", "no-official-IaC-provider"],
-      "reason": "獨立 vCluster Kubernetes API 與控制面資料；共用受管節點，支援標準 kubectl 工作負載子集。"
+      "reason": "獨立 Kubernetes API 與持久化管理資料；共用受管節點，支援標準 kubectl 工作負載子集。"
     },
     "gcp-vpc": {
       "name": "VPC / Firewall",
@@ -650,7 +650,7 @@
       "mode": "simplified",
       "operations": ["run-describe-terminate-instances", "stop-start", "instance-waiters", "exclusive-gpu-vm"],
       "limitations": ["requires-FUFU-infrastructure-backend", "Debian-12-only", "private-network", "single-node-disk", "GPU-requires-enabled-validated-node", "GPU-exclusive-until-delete", "no-GPU-hotplug-or-live-migration", "no-official-IaC-provider"],
-      "reason": "實際 KVM／KubeVirt VM；支援生命週期與 scoped instance ID，無官方 EC2 網路或完整 API。"
+      "reason": "實際 VM；支援生命週期與 scoped instance ID，無官方 EC2 網路或完整 API。"
     },
     "aws-ecs": {
       "name": "ECS / Fargate",
@@ -664,7 +664,7 @@
       "mode": "simplified",
       "operations": ["create-list-describe-delete", "update-kubeconfig", "cluster-waiters", "kubectl-workloads", "GPU-container-jobs"],
       "limitations": ["requires-FUFU-infrastructure-backend", "shared-workers", "single-control-plane-replica", "no-workload-PVC", "no-public-LoadBalancer", "no-interactive-exec-or-portforward", "no-official-IaC-provider"],
-      "reason": "獨立 vCluster Kubernetes API 與控制面資料；FUFU 短效認證，不是 AWS 原生 IAM 或託管控制面。"
+      "reason": "獨立 Kubernetes API 與持久化管理資料；FUFU 短效認證，不是 AWS 原生 IAM 或託管控制面。"
     },
     "aws-app-runner": {
       "name": "App Runner",

fufu_cloud_cli-0.11.1/src/fufu_cloud_cli/gateway_contract.py

@@ -0,0 +1,15 @@
+"""管理者配置的 API gateway；容器標籤只能由受信任的宿主控制器設定。"""
+import hashlib
+
+
+# Exact compatibility with the retired gateway label; no broader label matching.
+LEGACY_GATEWAY_LABEL = '261dbe856e015a13f8939aaae3315dd86b7f00294b5b6eaacca591e339859561'
+
+
+def api_gateway_labels(labels):
+    if not isinstance(labels, dict):
+        return False
+    bridge = labels.get('io.fufu.platform-bridge')
+    legacy = isinstance(bridge, str) and len(bridge) <= 128 and hashlib.sha256(bridge.encode()).hexdigest() == LEGACY_GATEWAY_LABEL
+    return labels.get('com.docker.compose.service') == 'local-cloud-console' or \
+        bridge == 'console-v1' or legacy

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1}/src/fufu_cloud_cli/infrastructure.py

@@ -1,4 +1,4 @@
-"""Native command subset backed by the private RKE2 infrastructure adapter."""
+"""Native command subset for FUFU managed compute and cluster services."""
 import base64
 import datetime
 import hashlib
@@ -27,7 +27,7 @@ VM_TYPES = {'e2-micro': (2, 1), 'e2-small': (2, 2), 'e2-medium': (2, 4), 'e2-sta
 
 
 def warn(kind):
-    sys.stderr.write('FUFU runtime: ' + ('KVM VM with a private network and one-node persistent disk; optional exclusive GPU on validated nodes, retained until deletion.\n' if kind == 'vm' else
+    sys.stderr.write('FUFU runtime: ' + ('VM with a private network and persistent disk without automatic failover; optional exclusive GPU in supported locations, retained until deletion.\n' if kind == 'vm' else
         'Independent Kubernetes API with shared worker nodes; private ClusterIP services, no workload PVCs or native cloud IAM.\n'))
 
 
@@ -49,7 +49,7 @@ def wait(api, kind, name, desired='RUNNING', seconds=480):
 
 
 def fufu_fields(value):
-    return {key: value.get(key) for key in ['name', 'state', 'mode', 'backend', 'node', 'limitations', 'spec'] if key in value}
+    return {key: value.get(key) for key in ['name', 'state', 'mode', 'node', 'limitations', 'spec'] if key in value} | {'backend': 'fufu'}
 
 
 def gcp_shape(value, kind):

{fufu_cloud_cli-0.11.0 → fufu_cloud_cli-0.11.1/src/fufu_cloud_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.11.0
+Version: 0.11.1
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
@@ -29,7 +29,7 @@ Dynamic: license-file
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
 0.11.0 新增獨占 GPU VM 的租用命令。需由平台啟用並驗證對應實體節點；
-支援的 RTX 3060 為整卡直通至 KVM 客體，可執行 NVIDIA 驅動與 CUDA。
+支援的 RTX 3060 以專用 GPU 提供給 VM，可執行 NVIDIA 驅動與 CUDA。
 停止 VM 仍保留整卡，刪除後才釋放。GPU 使用中或已保留會明確拒絕，
 不會自動中斷其他工作。CLI 不包含節點 SSH 金鑰、主機裝置管理程式或平台設定。
 
@@ -54,8 +54,8 @@ S3 bucket tags。需配套 FUFU API；不支援 bucket versioning、retention、
 KMS、bucket IAM、GCS bucket labels 或 force destroy。
 
 0.10.0 新增 Compute Engine／EC2 VM 與 GKE／EKS 介面的實際運算命令。
-需要啟用相應 infrastructure backend 的 FUFU 服務端；VM 使用 KVM／KubeVirt，
-叢集使用獨立 Kubernetes API 與共用節點，均不是官方雲端資源。
+需要啟用相應功能的 FUFU 服務端；提供實際 VM 與獨立 Kubernetes API，
+叢集使用共用運算資源，均不是官方雲端資源。
 支援 VM 建立、SSH 指令、停止／啟動與刪除，以及叢集建立、查詢、
 get-credentials／update-kubeconfig、waiter 與刪除。
 取得憑證後可使用標準 kubectl 部署 Deployment、Service、Job 及受管 GPU 容器。
@@ -145,7 +145,7 @@ BigQuery 是 tenant emulator 的 GoogleSQL 子集，無 DML／DDL、load/export
 
 0.9.4 新增 GCS generation／metageneration 條件、`storage objects describe/update/list`、8 KiB 自訂 metadata 與二進位 `cat`。競爭寫入、過期條件、CLI metadata 和官方 gcloud 輸出欄位已對照驗收；不相符條件回傳 `PRECONDITION_FAILED`／HTTP 412。新功能需要同步更新 FUFU Console、GCS 儲存映像和 Cloud Shell。儲存升級前須停寫並備份完整 volume；新 metadata 格式可讀舊資料，回滾須還原升級前備份。
 
-0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離 Docker 驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
+0.9.3 的常用輸出投影、清單篩選／排序／limit、Cloud Run 設定更新、Service Account 啟停及 Pub/Sub attributes／ACK deadline 持續保留。僅明列子集經過官方 gcloud、小用量真實 GCP 與隔離環境驗收；不表示完整 Google IAM、SDK／ADC 或自動擴縮相容。
 
 0.9.1 統一所有 CLI API 請求的 `User-Agent: fufu-cloud-cli`，涵蓋物件傳輸、
 Cloudflare 靜態檔案部署、IaC 遠端 state 與 Cloud Shell session，避免沿用

fufu_cloud_cli-0.11.0/src/fufu_cloud_cli/gateway_contract.py

@@ -1,8 +0,0 @@
-"""管理者配置的 API gateway；容器標籤只能由受信任的宿主控制器設定。"""
-
-
-def api_gateway_labels(labels):
-    if not isinstance(labels, dict):
-        return False
-    return labels.get('com.docker.compose.service') == 'local-cloud-console' or \
-        labels.get('io.fufu.platform-bridge') == 'console-rke2-v1'