fufu-cloud-cli 0.7.0__tar.gz → 0.9.0__tar.gz

{fufu_cloud_cli-0.7.0/src/fufu_cloud_cli.egg-info → fufu_cloud_cli-0.9.0}/PKG-INFO

@@ -1,22 +1,67 @@
 Metadata-Version: 2.4
 Name: fufu-cloud-cli
-Version: 0.7.0
+Version: 0.9.0
 Summary: FUFU Cloud CLI for tenant-scoped mock cloud development and deployment
 License-Expression: LicenseRef-Proprietary
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: PyYAML==6.0.3
+Requires-Dist: tomli==2.2.1; python_version < "3.11"
 Provides-Extra: yaml
 Requires-Dist: PyYAML==6.0.3; extra == "yaml"
+Provides-Extra: test
+Requires-Dist: boto3==1.40.66; extra == "test"
+Provides-Extra: terraform
+Requires-Dist: python-hcl2==7.3.1; extra == "terraform"
 Dynamic: license-file
 
 # FUFU Cloud CLI
 
-以四個指令操作 FUFU Cloud 的租戶隔離開發環境：`fufu`、`aws-fufu`、
-`gcloud-fufu`、`az-fufu`。這是 AWS、Google Cloud 與 Azure 的**明確子集**，
+以五個指令操作 FUFU Cloud 的租戶隔離開發環境：`fufu`、`aws-fufu`、
+`gcloud-fufu`、`az-fufu`、`wrangler-fufu`。這是 AWS、Google Cloud、Azure 與 Cloudflare 的**明確子集**，
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
+0.8.0 包含資源配額、分段傳輸、Terraform 核心子集與 Cloudflare 靜態部署／R2。需要同步更新服務端；CLI 安裝成功不表示任意 FUFU 服務端都已有這些能力。
+
+## Cloudflare 前端部署與 R2
+
+```bash
+pip install 'fufu-cloud-cli==0.8.0'
+export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
+wrangler-fufu capabilities
+wrangler-fufu pages project create frontend --production-branch main
+npm run build
+wrangler-fufu pages deploy dist --project-name frontend --branch main
+wrangler-fufu pages deployment list --project-name frontend
+wrangler-fufu deploy --assets dist --name frontend-assets
+wrangler-fufu r2 bucket create frontend-files
+wrangler-fufu r2 object put frontend-files/example.txt --file example.txt --remote
+```
+
+支援 Wrangler JSON、JSONC、TOML，以及 `--config`、`--cwd`、`--env`。Pages 使用
+`pages_build_output_dir`；Workers Static Assets 使用 `assets.directory`，SPA 可明確設定
+`assets.not_found_handling = "single-page-application"`。正式與預覽網址分開，正式部署完整
+上傳且校驗通過才切换入口；Pages 可用 `pages deployment rollback ID --project-name NAME` 回滾。
+
+這些命令提供真正的靜態 HTTP hosting，**不執行 Workers JavaScript 或 Pages Functions**。
+KV、D1、Durable Objects、Queues、Cron、自訂網域、SSR 與全球 CDN 快取未實作；
+相關配置會被拒絕。API credential、S3 endpoint 與帳號識別使用 FUFU 值。
+目前不讀取官方 `CLOUDFLARE_API_TOKEN`；使用 FUFU credential JSON，避免誤用正式金鑰。
+
+R2 支援 bucket／object、分段上傳、範圍下載、CORS、預設私人及可開關公開開發網址。
+原生 boto3／AWS S3 SDK 可使用 credential JSON 中的 `r2_endpoint`、`r2_access_key_id`、
+`r2_secret_access_key`，region 為 `auto` 且使用 path-style addressing。
+SDK checksum 配置使用 `WHEN_REQUIRED`；SigV4、預簽 PUT／GET、Content-MD5、
+基本自訂 metadata 與 multipart 已支援。未支援條件寫入、CopyObject、版本／生命週期、
+自訂加密，以及 Cache-Control／Content-Encoding 等寫入 metadata；會明確回錯，不靜默忽略。
+沒有 Cloudflare Terraform provider 相容層。
+
+静態檔案上限 25 MiB／每次最多 100,000 檔；R2 物件上限 5 TiB、S3 單次或分段上限
+5 GiB、最多 10,000 段。可用磁碟、請求逾時與併發容量仍會限制實際可接受大小。
+公開部署前拒絕私人路徑、符號連結與已知 credential 格式；此檢查不是所有機密的偵測器。
+FUFU 沒有 CDN 快取，入口回覆 `Cache-Control: no-store`，不模擬一次成功的 cache purge。
+
 ## 安裝
 
 需要 Python 3.10 以上。Python 套件預設包含 YAML 相依套件：
@@ -26,8 +71,8 @@ pip install fufu-cloud-cli
 fufu --version
 ```
 
-npm 版本需要 Node.js 18 以上，以及已安裝的 Python 3.10 以上；四個入口
-呼叫相同的 Python CLI。npm 包內附純 Python YAML parser，沒有安裝腳本，
+npm 版本需要 Node.js 18 以上，以及已安裝的 Python 3.10 以上；各入口
+呼叫相同的 Python CLI。0.8.0 的 npm 建置包內附純 Python YAML／TOML parser，沒有安裝腳本，
 不會自行下載 Python 或執行 pip。
 
 ```bash
@@ -43,6 +88,27 @@ npx --no-install aws-fufu --help
 
 ## 憑證與 CI
 
+目前工作樹另提供 `fufu tofu`、`fufu pulumi`、`fufu state`。
+Terraform／OpenTofu 可選擇租戶遠端 HTTP state，具備鎖、加密、版本與
+復原；需配套 Console API 和平台金鑰。Pulumi 使用固定官方 Node.js SDK，
+已驗收 SQS、SSM String、Pub/Sub topic／pull subscription，採獨立本機
+DIY backend，秘密欄位需外部 passphrase。這些新能力尚未包含在已發布
+的 0.8.0，不能把套件安裝成功當成支援驗收。
+
+此工作樹也提供 `fufu terraform`：以官方 AWS／Google Terraform provider
+管理 Lambda ZIP、Cloud Run v2、IAM 與服務入口的明列子集，並使用獨立的
+FUFU state。Terraform 需另行安裝，Python 使用 `fufu-cloud-cli[terraform]`
+extra；npm 使用的 Python 也需要該 extra 的相依套件。使用 0.8.0 以上版本。
+GCS／S3、Functions Gen 1／Gen 2 等一般 CLI 能力
+不表示官方 Terraform 資源已相容。正式環境使用正常 Terraform、正式認證
+與獨立 state，不可直接搬用 FUFU state。
+
+後續開發版另接入 SQS queue、SSM String parameter、Pub/Sub topic／pull
+subscription；新增能力需要配套的 Console 與 Pub/Sub 後端更新，不能從
+已發布的 0.8.0 安裝成功就推定已具備。`gcloud-fufu pubsub` 提供建立、
+查詢、更新、刪除、publish／pull／ack 子集；不支援 push、ordering、
+exactly-once、Function trigger 或保留期限保證。
+
 向 FUFU Cloud 管理者取得該租戶、該 provider 的專用 credential JSON。
 CLI 不附預設帳號、共用金鑰或可用的租戶憑證，也不讀取 `.env`、瀏覽器
 Cookie 或正式雲端登入工作階段。
@@ -54,11 +120,13 @@ export FUFU_BACKEND=api
 export FUFU_AWS_CREDENTIAL_FILE=/run/secrets/fufu-aws.json
 export FUFU_GCP_CREDENTIAL_FILE=/run/secrets/fufu-gcp.json
 export FUFU_AZURE_CREDENTIAL_FILE=/run/secrets/fufu-azure.json
+export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
 
 fufu auth whoami --provider aws
 aws-fufu sts get-caller-identity
 gcloud-fufu auth list
 az-fufu account show
+wrangler-fufu whoami
 ```
 
 credential 內含 FUFU endpoint。`FUFU_ENDPOINT` 可明確覆寫目的地：僅限
@@ -74,6 +142,32 @@ Lambda Function URL 的 AWS_IAM 支援長效 FUFU access key 的 SigV4 header si
 
 ## 部署與支援範圍
 
+0.9.0 的配套後端新增 AWS／GCP Secrets Manager、GCP 部署秘密參照、
+Cloud Run SSE／WebSocket、HTTP Functions SSE，以及目前運行版本的身分續期。
+服務端須配置私有加密金鑰；未配置時會明確拒絕秘密操作。
+
+```bash
+aws-fufu secretsmanager create-secret --name app-key --secret-string file://./dev-secret.txt
+aws-fufu secretsmanager get-secret-value --secret-id app-key --out-file ./private-result.txt
+gcloud-fufu secrets create app-key --data-file ./dev-secret.txt
+gcloud-fufu run deploy example --source ./prepared-asgi.zip \
+  --service-account "$WORKLOAD_SERVICE_ACCOUNT" --set-secrets APP_KEY=app-key:1
+```
+
+秘密值只由受控檔案或 `--secret-env VARIABLE` 輸入；讀取需指定私有新檔案，
+不會輸出到終端。Cloud Run／Functions 的 service account 需 Secret Accessor
+權限。支援 `--update-secrets`、`--clear-secrets` 和 Knative `secretKeyRef`。
+這是本機加密版本管理子集：AWS 為 UTF-8 SecretString，單值最大 64 KiB；
+無 KMS、rotation、跨區域複寫、排程刪除與復原。立即刪除或銷毀後，加密
+備份與既有容器可能仍持有舊值。CLI metadata 採 FUFU 共用形狀，並非完整
+官方 JSON；GCP runtime 使用明確 helper，無全量 Google SDK／ADC 替換。
+新的秘密資源與 Terraform／OpenTofu／Pulumi 參照尚未接通。
+
+Cloud Run 串流回應不設原本的 32 MiB 緩衝上限，仍受服務期限及容量限制。
+HTTP Functions Gen 1／Gen 2 支援 SSE、無 WebSocket；Gen 2 保留較寬鬆的
+32 MiB response，而官方 streaming response 是 10 MB。Lambda 仍為 buffered。
+公網 DNS、TLS、WAF 及 CDN 期限須另外驗證。
+
 ```bash
 fufu capabilities
 fufu capabilities --remote --provider gcp --require cloud-run-http
@@ -88,7 +182,7 @@ aws-fufu lambda list-functions
 接受已封裝 Uvicorn 與相依套件的 Python 3.12 ASGI ZIP／乾淨目錄，自動離線建置、
 檢查映像並核准到目前租戶；不需要主機 SSH 或每次人工核准。
 `--entry-point module:app` 是 FUFU 擴充旗標，預設 `main:app`。
-來源上限為 ZIP 6 MiB、解壓縮 32 MiB、2000 個檔案；不接受隱藏檔、Dockerfile、
+目前來源版本的 FUFU 配方上限為 ZIP 512 MiB、解壓縮 2 GiB、100000 個檔案；不接受隱藏檔、Dockerfile、
 自訂安裝設定或非空 requirements.txt。相依套件需在 CI 封裝，服務端不執行安裝 hook。
 這是固定 ASGI 配方，不提供完整 Cloud Build 或 registry API。
 成功回應包含 `build.status`、`imageDigest` 與來源包雜湊；自動核准映像
@@ -103,8 +197,8 @@ CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 | --- | --- |
 | Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；支援配置後的 HTTPS 入口、Invoker policy；無 autoscaling、traffic splitting、Jobs |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
-| AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；遠端 ZIP 上限 6 MiB |
-| GCS / S3 | bucket 與 object 操作子集；單一 object 上限 6 MiB，無 versioning / signed URL |
+| AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；ZIP 50 MiB／解壓 250 MiB，同步 payload 6 MiB |
+| GCS / S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
 | DynamoDB / SQS / SSM | 明列資料操作；無完整交易、Streams、FIFO 或 KMS / SecureString |
 | AWS IAM / GCP IAM | 租戶內 role / service account / policy 子集；default deny、限定 session；無原生雲端全量 IAM 語義 |
 | API Gateway / Serverless profile | 簡化 HTTP Lambda proxy 和明確來源清單；不執行 plugins / CloudFormation |
@@ -142,7 +236,8 @@ UI 與 CLI 共用同一份服務政策。Cloud Run 與 HTTP Functions 的匿名
 `allUsers` 與對應 Invoker 角色。Lambda `NONE` 必須另加 `lambda:InvokeFunctionUrl`
 （`--function-url-auth-type NONE`）和 `lambda:InvokeFunction`
 （`--invoked-via-function-url`）兩項資源權限；只設定 NONE 不會自動開放呼叫。
-入口支援有界限的普通 HTTP：請求與回應各 6 MiB、執行 15 秒，每服務每分鐘 120 次。
+入口支援有界限的普通 HTTP：Lambda 請求與回應各 6 MiB、Gen 1 各 10 MiB、Run／Gen 2 各 32 MiB。
+依服務設定等待，期限上限分別為 900／540／3600 秒；外部 CDN 期限另計。每服務每分鐘 6000 次，另有主機容量背壓。
 不支援 SSE、WebSocket、串流、STS 暫時金鑰、presigned URL 或真實 VPC。
 GCP ID token 由 FUFU 的 RS256 issuer 簽發，綁定精確 audience，15 分鐘後過期；不接受 Google ID token。
 `print-identity-token` 明確輸出秘密，應直接放入受控變數，避免 CI 日誌或 shell tracing。

{fufu_cloud_cli-0.7.0 → fufu_cloud_cli-0.9.0}/README.md

@@ -1,9 +1,49 @@
 # FUFU Cloud CLI
 
-以四個指令操作 FUFU Cloud 的租戶隔離開發環境：`fufu`、`aws-fufu`、
-`gcloud-fufu`、`az-fufu`。這是 AWS、Google Cloud 與 Azure 的**明確子集**，
+以五個指令操作 FUFU Cloud 的租戶隔離開發環境：`fufu`、`aws-fufu`、
+`gcloud-fufu`、`az-fufu`、`wrangler-fufu`。這是 AWS、Google Cloud、Azure 與 Cloudflare 的**明確子集**，
 只供 FUFU mock 環境使用；不會把部署轉送到正式雲端。
 
+0.8.0 包含資源配額、分段傳輸、Terraform 核心子集與 Cloudflare 靜態部署／R2。需要同步更新服務端；CLI 安裝成功不表示任意 FUFU 服務端都已有這些能力。
+
+## Cloudflare 前端部署與 R2
+
+```bash
+pip install 'fufu-cloud-cli==0.8.0'
+export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
+wrangler-fufu capabilities
+wrangler-fufu pages project create frontend --production-branch main
+npm run build
+wrangler-fufu pages deploy dist --project-name frontend --branch main
+wrangler-fufu pages deployment list --project-name frontend
+wrangler-fufu deploy --assets dist --name frontend-assets
+wrangler-fufu r2 bucket create frontend-files
+wrangler-fufu r2 object put frontend-files/example.txt --file example.txt --remote
+```
+
+支援 Wrangler JSON、JSONC、TOML，以及 `--config`、`--cwd`、`--env`。Pages 使用
+`pages_build_output_dir`；Workers Static Assets 使用 `assets.directory`，SPA 可明確設定
+`assets.not_found_handling = "single-page-application"`。正式與預覽網址分開，正式部署完整
+上傳且校驗通過才切换入口；Pages 可用 `pages deployment rollback ID --project-name NAME` 回滾。
+
+這些命令提供真正的靜態 HTTP hosting，**不執行 Workers JavaScript 或 Pages Functions**。
+KV、D1、Durable Objects、Queues、Cron、自訂網域、SSR 與全球 CDN 快取未實作；
+相關配置會被拒絕。API credential、S3 endpoint 與帳號識別使用 FUFU 值。
+目前不讀取官方 `CLOUDFLARE_API_TOKEN`；使用 FUFU credential JSON，避免誤用正式金鑰。
+
+R2 支援 bucket／object、分段上傳、範圍下載、CORS、預設私人及可開關公開開發網址。
+原生 boto3／AWS S3 SDK 可使用 credential JSON 中的 `r2_endpoint`、`r2_access_key_id`、
+`r2_secret_access_key`，region 為 `auto` 且使用 path-style addressing。
+SDK checksum 配置使用 `WHEN_REQUIRED`；SigV4、預簽 PUT／GET、Content-MD5、
+基本自訂 metadata 與 multipart 已支援。未支援條件寫入、CopyObject、版本／生命週期、
+自訂加密，以及 Cache-Control／Content-Encoding 等寫入 metadata；會明確回錯，不靜默忽略。
+沒有 Cloudflare Terraform provider 相容層。
+
+静態檔案上限 25 MiB／每次最多 100,000 檔；R2 物件上限 5 TiB、S3 單次或分段上限
+5 GiB、最多 10,000 段。可用磁碟、請求逾時與併發容量仍會限制實際可接受大小。
+公開部署前拒絕私人路徑、符號連結與已知 credential 格式；此檢查不是所有機密的偵測器。
+FUFU 沒有 CDN 快取，入口回覆 `Cache-Control: no-store`，不模擬一次成功的 cache purge。
+
 ## 安裝
 
 需要 Python 3.10 以上。Python 套件預設包含 YAML 相依套件：
@@ -13,8 +53,8 @@ pip install fufu-cloud-cli
 fufu --version
 ```
 
-npm 版本需要 Node.js 18 以上，以及已安裝的 Python 3.10 以上；四個入口
-呼叫相同的 Python CLI。npm 包內附純 Python YAML parser，沒有安裝腳本，
+npm 版本需要 Node.js 18 以上，以及已安裝的 Python 3.10 以上；各入口
+呼叫相同的 Python CLI。0.8.0 的 npm 建置包內附純 Python YAML／TOML parser，沒有安裝腳本，
 不會自行下載 Python 或執行 pip。
 
 ```bash
@@ -30,6 +70,27 @@ npx --no-install aws-fufu --help
 
 ## 憑證與 CI
 
+目前工作樹另提供 `fufu tofu`、`fufu pulumi`、`fufu state`。
+Terraform／OpenTofu 可選擇租戶遠端 HTTP state，具備鎖、加密、版本與
+復原；需配套 Console API 和平台金鑰。Pulumi 使用固定官方 Node.js SDK，
+已驗收 SQS、SSM String、Pub/Sub topic／pull subscription，採獨立本機
+DIY backend，秘密欄位需外部 passphrase。這些新能力尚未包含在已發布
+的 0.8.0，不能把套件安裝成功當成支援驗收。
+
+此工作樹也提供 `fufu terraform`：以官方 AWS／Google Terraform provider
+管理 Lambda ZIP、Cloud Run v2、IAM 與服務入口的明列子集，並使用獨立的
+FUFU state。Terraform 需另行安裝，Python 使用 `fufu-cloud-cli[terraform]`
+extra；npm 使用的 Python 也需要該 extra 的相依套件。使用 0.8.0 以上版本。
+GCS／S3、Functions Gen 1／Gen 2 等一般 CLI 能力
+不表示官方 Terraform 資源已相容。正式環境使用正常 Terraform、正式認證
+與獨立 state，不可直接搬用 FUFU state。
+
+後續開發版另接入 SQS queue、SSM String parameter、Pub/Sub topic／pull
+subscription；新增能力需要配套的 Console 與 Pub/Sub 後端更新，不能從
+已發布的 0.8.0 安裝成功就推定已具備。`gcloud-fufu pubsub` 提供建立、
+查詢、更新、刪除、publish／pull／ack 子集；不支援 push、ordering、
+exactly-once、Function trigger 或保留期限保證。
+
 向 FUFU Cloud 管理者取得該租戶、該 provider 的專用 credential JSON。
 CLI 不附預設帳號、共用金鑰或可用的租戶憑證，也不讀取 `.env`、瀏覽器
 Cookie 或正式雲端登入工作階段。
@@ -41,11 +102,13 @@ export FUFU_BACKEND=api
 export FUFU_AWS_CREDENTIAL_FILE=/run/secrets/fufu-aws.json
 export FUFU_GCP_CREDENTIAL_FILE=/run/secrets/fufu-gcp.json
 export FUFU_AZURE_CREDENTIAL_FILE=/run/secrets/fufu-azure.json
+export FUFU_CLOUDFLARE_CREDENTIAL_FILE=/run/secrets/fufu-cloudflare.json
 
 fufu auth whoami --provider aws
 aws-fufu sts get-caller-identity
 gcloud-fufu auth list
 az-fufu account show
+wrangler-fufu whoami
 ```
 
 credential 內含 FUFU endpoint。`FUFU_ENDPOINT` 可明確覆寫目的地：僅限
@@ -61,6 +124,32 @@ Lambda Function URL 的 AWS_IAM 支援長效 FUFU access key 的 SigV4 header si
 
 ## 部署與支援範圍
 
+0.9.0 的配套後端新增 AWS／GCP Secrets Manager、GCP 部署秘密參照、
+Cloud Run SSE／WebSocket、HTTP Functions SSE，以及目前運行版本的身分續期。
+服務端須配置私有加密金鑰；未配置時會明確拒絕秘密操作。
+
+```bash
+aws-fufu secretsmanager create-secret --name app-key --secret-string file://./dev-secret.txt
+aws-fufu secretsmanager get-secret-value --secret-id app-key --out-file ./private-result.txt
+gcloud-fufu secrets create app-key --data-file ./dev-secret.txt
+gcloud-fufu run deploy example --source ./prepared-asgi.zip \
+  --service-account "$WORKLOAD_SERVICE_ACCOUNT" --set-secrets APP_KEY=app-key:1
+```
+
+秘密值只由受控檔案或 `--secret-env VARIABLE` 輸入；讀取需指定私有新檔案，
+不會輸出到終端。Cloud Run／Functions 的 service account 需 Secret Accessor
+權限。支援 `--update-secrets`、`--clear-secrets` 和 Knative `secretKeyRef`。
+這是本機加密版本管理子集：AWS 為 UTF-8 SecretString，單值最大 64 KiB；
+無 KMS、rotation、跨區域複寫、排程刪除與復原。立即刪除或銷毀後，加密
+備份與既有容器可能仍持有舊值。CLI metadata 採 FUFU 共用形狀，並非完整
+官方 JSON；GCP runtime 使用明確 helper，無全量 Google SDK／ADC 替換。
+新的秘密資源與 Terraform／OpenTofu／Pulumi 參照尚未接通。
+
+Cloud Run 串流回應不設原本的 32 MiB 緩衝上限，仍受服務期限及容量限制。
+HTTP Functions Gen 1／Gen 2 支援 SSE、無 WebSocket；Gen 2 保留較寬鬆的
+32 MiB response，而官方 streaming response 是 10 MB。Lambda 仍為 buffered。
+公網 DNS、TLS、WAF 及 CDN 期限須另外驗證。
+
 ```bash
 fufu capabilities
 fufu capabilities --remote --provider gcp --require cloud-run-http
@@ -75,7 +164,7 @@ aws-fufu lambda list-functions
 接受已封裝 Uvicorn 與相依套件的 Python 3.12 ASGI ZIP／乾淨目錄，自動離線建置、
 檢查映像並核准到目前租戶；不需要主機 SSH 或每次人工核准。
 `--entry-point module:app` 是 FUFU 擴充旗標，預設 `main:app`。
-來源上限為 ZIP 6 MiB、解壓縮 32 MiB、2000 個檔案；不接受隱藏檔、Dockerfile、
+目前來源版本的 FUFU 配方上限為 ZIP 512 MiB、解壓縮 2 GiB、100000 個檔案；不接受隱藏檔、Dockerfile、
 自訂安裝設定或非空 requirements.txt。相依套件需在 CI 封裝，服務端不執行安裝 hook。
 這是固定 ASGI 配方，不提供完整 Cloud Build 或 registry API。
 成功回應包含 `build.status`、`imageDigest` 與來源包雜湊；自動核准映像
@@ -90,8 +179,8 @@ CLI 無法判斷任意原始碼或 ZIP 內的資料是否可以分享。
 | --- | --- |
 | Cloud Run | 已核准 HTTP 容器或 API 自動建置 Python ASGI 來源；支援配置後的 HTTPS 入口、Invoker policy；無 autoscaling、traffic splitting、Jobs |
 | Cloud Run functions / Functions Gen 1 | Python 3.12 HTTP 函式；Gen 1 為相同 HTTP runtime 的模擬子集，無背景事件 |
-| AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；遠端 ZIP 上限 6 MiB |
-| GCS / S3 | bucket 與 object 操作子集；單一 object 上限 6 MiB，無 versioning / signed URL |
+| AWS Lambda | Python 3.10 / 3.12 ZIP、同步 invoke、程式碼更新、BUFFERED Function URL；ZIP 50 MiB／解壓 250 MiB，同步 payload 6 MiB |
+| GCS / S3 | bucket 與 object 子集；分段上傳／串流下載，受主機磁碟限制；已驗證超過 1 GiB，無 versioning / signed URL |
 | DynamoDB / SQS / SSM | 明列資料操作；無完整交易、Streams、FIFO 或 KMS / SecureString |
 | AWS IAM / GCP IAM | 租戶內 role / service account / policy 子集；default deny、限定 session；無原生雲端全量 IAM 語義 |
 | API Gateway / Serverless profile | 簡化 HTTP Lambda proxy 和明確來源清單；不執行 plugins / CloudFormation |
@@ -129,7 +218,8 @@ UI 與 CLI 共用同一份服務政策。Cloud Run 與 HTTP Functions 的匿名
 `allUsers` 與對應 Invoker 角色。Lambda `NONE` 必須另加 `lambda:InvokeFunctionUrl`
 （`--function-url-auth-type NONE`）和 `lambda:InvokeFunction`
 （`--invoked-via-function-url`）兩項資源權限；只設定 NONE 不會自動開放呼叫。
-入口支援有界限的普通 HTTP：請求與回應各 6 MiB、執行 15 秒，每服務每分鐘 120 次。
+入口支援有界限的普通 HTTP：Lambda 請求與回應各 6 MiB、Gen 1 各 10 MiB、Run／Gen 2 各 32 MiB。
+依服務設定等待，期限上限分別為 900／540／3600 秒；外部 CDN 期限另計。每服務每分鐘 6000 次，另有主機容量背壓。
 不支援 SSE、WebSocket、串流、STS 暫時金鑰、presigned URL 或真實 VPC。
 GCP ID token 由 FUFU 的 RS256 issuer 簽發，綁定精確 audience，15 分鐘後過期；不接受 Google ID token。
 `print-identity-token` 明確輸出秘密，應直接放入受控變數，避免 CI 日誌或 shell tracing。

{fufu_cloud_cli-0.7.0 → fufu_cloud_cli-0.9.0}/pyproject.toml

@@ -4,25 +4,28 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "fufu-cloud-cli"
-version = "0.7.0"
+version = "0.9.0"
 description = "FUFU Cloud CLI for tenant-scoped mock cloud development and deployment"
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = ["PyYAML==6.0.3"]
+dependencies = ["PyYAML==6.0.3", "tomli==2.2.1; python_version<'3.11'"]
 license = "LicenseRef-Proprietary"
 license-files = ["LICENSE"]
 
 [project.optional-dependencies]
 yaml = ["PyYAML==6.0.3"]
+test = ["boto3==1.40.66"]
+terraform = ["python-hcl2==7.3.1"]
 
 [project.scripts]
 fufu = "fufu_cloud_cli.cli:main"
 aws-fufu = "fufu_cloud_cli.cli:aws_main"
 gcloud-fufu = "fufu_cloud_cli.cli:gcloud_main"
 az-fufu = "fufu_cloud_cli.cli:az_main"
+wrangler-fufu = "fufu_cloud_cli.cli:wrangler_main"
 
 [tool.setuptools.packages.find]
 where = ["src"]
 
 [tool.setuptools.package-data]
-fufu_cloud_cli = ["capabilities.json", "runtime/*/Dockerfile", "runtime/ingress/proxy.py"]
+fufu_cloud_cli = ["capabilities.json", "pulumi-endpoints.json", "runtime/*/Dockerfile", "runtime/ingress/proxy.py"]

{fufu_cloud_cli-0.7.0 → fufu_cloud_cli-0.9.0}/src/fufu_cloud_cli/__init__.py

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

{fufu_cloud_cli-0.7.0 → fufu_cloud_cli-0.9.0}/src/fufu_cloud_cli/api_backend.py

@@ -15,8 +15,10 @@ from urllib.request import HTTPRedirectHandler, HTTPSHandler, ProxyHandler, Requ
 
 from .errors import FufuError, require
 
-PROVIDERS = {"aws", "gcp", "azure"}
-MAX_RESPONSE = 2 * 1024 * 1024
+PROVIDERS = {"aws", "gcp", "azure", "cloudflare"}
+from .limits import JSON_BODY_BYTES, JSON_RESPONSE_BYTES
+
+MAX_RESPONSE = 8 * 1024 * 1024
 
 
 @contextmanager
@@ -71,7 +73,7 @@ def api_selected():
         return False
     return mode == "api" or any(os.environ.get(k) for k in (
         "FUFU_ENDPOINT", "FUFU_CREDENTIAL_FILE", "FUFU_AWS_CREDENTIAL_FILE",
-        "FUFU_GCP_CREDENTIAL_FILE", "FUFU_AZURE_CREDENTIAL_FILE", 'FUFU_SESSION_FILE')) or os.environ.get("AWS_ACCESS_KEY_ID", "").startswith("FUFU")
+        "FUFU_GCP_CREDENTIAL_FILE", "FUFU_AZURE_CREDENTIAL_FILE", "FUFU_CLOUDFLARE_CREDENTIAL_FILE", 'FUFU_SESSION_FILE')) or os.environ.get("AWS_ACCESS_KEY_ID", "").startswith("FUFU")
 
 
 def load_credential(provider=None, filename=None):
@@ -93,7 +95,7 @@ def load_credential(provider=None, filename=None):
             and data.get("fufu_provider") in PROVIDERS, "INVALID_CREDENTIAL", "需要 FUFU 專用憑證；不接受正式雲端金鑰。")
     actual = data["fufu_provider"]
     require(provider is None or actual == provider, "PROVIDER_MISMATCH", "憑證所屬 provider 不符。")
-    fields = {"aws": ("aws_access_key_id", "aws_secret_access_key"), "gcp": ("client_id", "client_secret"), "azure": ("clientId", "clientSecret")}
+    fields = {"aws": ("aws_access_key_id", "aws_secret_access_key"), "gcp": ("client_id", "client_secret"), "azure": ("clientId", "clientSecret"), "cloudflare": ("credential_id", "api_token")}
     key, secret = (data.get(k) for k in fields[actual])
     require(isinstance(key, str) and re.fullmatch(r"FUFU" + actual.upper() + r"[A-Za-z0-9_-]{12,100}", key)
             and isinstance(secret, str) and 24 <= len(secret) <= 1024,
@@ -160,30 +162,48 @@ class ApiClient:
             headers["Authorization"] = f"Bearer {self.token}"
         data = None if body is None else json.dumps(body).encode("utf-8")
         if data is not None:
-            require(len(data) <= (12 * 1024**2 if large else 65536), "PAYLOAD_LIMIT", "API JSON payload 超過上限。")
+            require(len(data) <= (JSON_BODY_BYTES if large else 1024**2), "PAYLOAD_LIMIT", "API JSON payload 超過上限。")
             headers["Content-Type"] = "application/json"
         req = Request(self.endpoint + path, data=data, headers=headers, method=method)
         try:
-            with request_deadline(), self.opener.open(req, timeout=15) as response:
-                limit = 9 * 1024**2 if large else MAX_RESPONSE
+            duration = min(3630, max(60, int(body.get("timeout", 30)) + 30)) if large and isinstance(body, dict) else 60
+            if '/objects/uploads/' in path and path.endswith('/complete'): duration = 3630
+            with request_deadline(duration), self.opener.open(req, timeout=duration) as response:
+                limit = JSON_RESPONSE_BYTES if large else MAX_RESPONSE
                 raw = response.read(limit + 1)
                 require(len(raw) <= limit, "RESPONSE_LIMIT", "API 回覆超過大小限制。")
                 return json.loads(raw)
         except HTTPError as exc:
             status = exc.code
             exc.close()
-            codes = {401: "AUTHENTICATION_FAILED", 403: "ACCESS_DENIED", 404: "RESOURCE_NOT_FOUND", 409: "RESOURCE_CONFLICT", 429: "RATE_LIMITED"}
+            codes = {401: "AUTHENTICATION_FAILED", 403: "ACCESS_DENIED", 404: "RESOURCE_NOT_FOUND", 409: "RESOURCE_CONFLICT", 410: "UPLOAD_EXPIRED", 413: "PAYLOAD_LIMIT", 429: "RATE_LIMITED", 507: "STORAGE_CAPACITY"}
+            if status == 507: raise FufuError('STORAGE_CAPACITY', 'FUFU 主機磁碟容量不足；這是目前可用空間的限制，並非雲端物件大小上限。') from None
             raise FufuError(codes.get(status, "API_REQUEST_FAILED"), f"FUFU API 拒絕請求（HTTP {status}）；未輸出憑證或原始回應。") from None
         except (URLError, TimeoutError, ConnectionError) as exc:
             raise FufuError("API_UNREACHABLE", "無法在時限內安全連線至 FUFU API。") from None
 
     def request(self, method, path, body=None):
-        return self._request(method, f"/api/cloud/{self.provider}" + path, body, large=path.startswith(('/compute/', '/s3/', '/storage/', '/control/native')))
+        return self._request(method, f"/api/cloud/{self.provider}" + path, body, large=path.startswith(('/compute/', '/s3/', '/storage/', '/control/native', '/control/pubsub', '/sites')))
 
     def whoami(self):
         data = self._request("GET", "/api/auth/whoami")
         return {k: v for k, v in data.items() if k != "credentialId"}
 
+    def binary(self, method, path, stream=None, length=None):
+        require((path.startswith('/objects/') or self.provider == 'cloudflare' and path.startswith(('/sites/', '/r2/')))
+                and '\r' not in path and '\n' not in path, 'INVALID_REQUEST', '物件傳輸路徑無效。')
+        headers = {'Authorization': 'Bearer '+self.token, 'Content-Type': 'application/octet-stream'}
+        if length is not None: headers['Content-Length'] = str(length)
+        request = Request(self.endpoint+f'/api/cloud/{self.provider}'+path, data=stream, headers=headers, method=method)
+        try:
+            response = self.opener.open(request, timeout=300)
+            if method == 'GET': return response
+            with response:
+                return json.loads(response.read(65537))
+        except HTTPError as error:
+            status = error.code; error.close()
+            raise FufuError('OBJECT_TRANSFER_FAILED', f'物件傳輸未完成（HTTP {status}）；未覆寫下載目的地。') from None
+
     def close(self):
         if self.token and self.owns_token:
             try:
@@ -279,12 +299,11 @@ def remote_command(provider, argv, Parser):
         if a.action == "buckets" and a.bucket_action == "list":
             return api.request("GET", "/storage/buckets")
         if a.action == 'cp' and a.source.startswith('gs://'):
-            from .cloud_data import download_bytes
+            from .object_transfer import download_file
             require(not a.destination.startswith('gs://'), 'UNSUPPORTED_ARGUMENT', 'cp 目前只支援本機與 Storage 之間傳輸。')
             bucket, key = storage_path(a.source)
             require(bool(key), 'INVALID_RESOURCE', '請指定 object 名稱。')
-            result = api.request('GET', '/storage/buckets/' + bucket + '/object?' + urlencode({'name': key, 'encoding': 'base64'}))
-            return download_bytes(a.destination, result['contentBase64'])
+            return download_file(api, a.destination, bucket, key)
         bucket, key = storage_path(a.destination if a.action == "cp" else a.url)
         path = "/storage/buckets/" + bucket
         if a.action == "buckets":
@@ -298,5 +317,5 @@ def remote_command(provider, argv, Parser):
             return api.request("GET", path + "/object?" + urlencode({"name": key}))
         if a.action == "rm":
             return api.request("DELETE", path + "/object?" + urlencode({"name": key}))
-        from .cloud_data import upload_bytes
-        return api.request("POST", path + "/objects", {"name": key, "contentBase64": upload_bytes(a.source)})
+        from .object_transfer import upload_file
+        return upload_file(api, a.source, bucket, key)