bizy-deploy 0.2.0__tar.gz

bizy_deploy-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SiliconFlow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bizy_deploy-0.2.0/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: bizy-deploy
+Version: 0.2.0
+Summary: BizyAir FaaS automated deployment tool
+Author-email: SiliconFlow <bizyair@siliconflow.cn>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/siliconflow/BizyDeploy
+Project-URL: Repository, https://github.com/siliconflow/BizyDeploy
+Project-URL: Issues, https://github.com/siliconflow/BizyDeploy/issues
+Keywords: faas,deploy,siliconflow,bizyair
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: hydra-core
+Requires-Dist: loguru
+Requires-Dist: pyyaml
+Provides-Extra: scripts
+Requires-Dist: httpx; extra == "scripts"
+Requires-Dist: pillow; extra == "scripts"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+## 安装
+## 1. 安装（二选一）
+
+```bash
+# 公有仓库
+pip install git+https://<TOKEN>@github.com/siliconflow/BizyDeploy.git
+```
+
+```bash
+# 私有仓库
+pip install git+ssh://git@github.com/siliconflow/BizyDeploy.git
+```
+
+## 使用
+
+```bash
+export SF_FAAS_TOKEN=xxxxx
+```
+
+### 场景1: 仅更新faas云函数部署 
+```
+bizy-deploy \
+  pipeline=cgr_uat \
+  service.sf_faas_token="$SF_FAAS_TOKEN" \
+  ++env.function_id=fnjfvlqpdt \
+  ++env.deployment_id=fdqd9p8te5 \
+  ++func_def.spec.comment="upgrade"
+```
+
+### 场景2: 仅更新镜像版本 (最常用)
+
+下面镜像对应云函数地址: https://cloud.siliconflow.cn/sft-d1s6t1r3jrms73f3ltpg/dedicated/functions/fnjfvlqpdt?tab=definition
+
+命令行中的 ++func_def.spec.data 对应控制台“函数定义”中的 YAML 结构 
+
+```bash
+bizy-deploy \
+  debug=false \
+  pipeline=cgr_prod \
+  service.sf_faas_token="$SF_FAAS_TOKEN" \
+  ++env.function_id=fnjfvlqpdt \
+  ++env.deployment_id=fdqd9p8te5 \
+  ++func_def.spec.comment="update image to v20251222" \
+  ++func_def.spec.data.cgrService.image="hub.6scloud.com/xxx/comfygridruntime:v20251222"
+```
+
+### 场景: 云函数模版相关操作
+
+#### 获取 {org_id}/{template_id} 对应云函数模版
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  debug=true \
+  ++pipeline.0.action='get_template' \
+  ++pipeline.0.params.org_id=d1s6t1r3jrms73f3ltpg \
+  ++pipeline.0.params.template_id=bizydraft-backend \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+```
+
+### 场景4: 从源云函数上获取配置，修改指定参数后上传到目标云函数，并部署等待就绪
+
+```bash
+bizy-deploy \
+  pipeline=cgr_uat \
+  ++pipeline.0.params.function_id=fna5m4t5ky \
+  ++env.function_id=fn1tioyopg \
+  ++env.deployment_id=fdg8skissk \
+  ++func_def.spec.data.comfyagentService.nodeRegisterConfigUrl="https://storage.bizyair.cn/config/comfyagent_node_config_chenchaonan.json" \
+  ++func_def.spec.data.comfyuiService.image="hub.6scloud.com/d1s6t1r3jrms73f3ltpg/comfyui-gpu-torch2dot5:v202512241113-feature-add-plugins-default-a8dc7ab" \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+```
+### 场景5: 得到一个函数的最新定义，创建一个新的定义，修改部署的参数后部署并等待就绪
+
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  ++pipeline.0.action='get_latest_function_definition' \
+  ++pipeline.0.params.function_id=fn1tioyopg \
+  ++pipeline.0.save_result_as='latest_func_def' \
+  ++pipeline.1.action='create_function_definition' \
+  ++pipeline.1.params.function_id=fn1tioyopg \
+  ++pipeline.1.params.merged_def='${pipe.ctx:latest_func_def}' \
+  ++pipeline.1.save_result_as="new_version" \
+  ++pipeline.2.action='deploy' \
+  ++pipeline.2.params.version='${pipe.ctx:new_version}' \
+  ++pipeline.2.params.overrides.spec.siliconServices.0.minReplicas=2 \
+  ++pipeline.2.params.overrides.spec.siliconServices.0.maxReplicas=5 \
+  ++pipeline.2.params.function_id=fn1tioyopg \
+  ++pipeline.2.params.deployment_id="fdg8skissk" \
+  ++pipeline.3.action='wait_ready' \
+  ++pipeline.3.params.function_id=fn1tioyopg \
+  ++pipeline.3.params.deployment_id=fdg8skissk \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+
+```python
+python scripts/save_template.py -tpl d1s6t1r3jrms73f3ltpg/bizydraft-backend 
+```
+
+<details open>
+<summary> Output </summary>
+
+```
+✔ Template saved: d1s6t1r3jrms73f3ltpg/bizydraft-backend -> 
+outputs/d1s6t1r3jrms73f3ltpg---bizydraft-backend.yaml
+```
+
+</details>
+
+
+#### 更新模版
+
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  ++pipeline.0.action='update_template' \
+  ++pipeline.0.params.name=<template_id> \
+  ++pipeline.0.params.data.files=<TemplateYamlPath> \
+  service.sf_faas_token="<SF_FAAS_TOKEN>"
+```
+
+#### 前端更新完成后清理缓存
+
+```bash
+# 通过环境变量设置使用
+export BIZYAIR_TOKEN=sk-xxx     # 设置bizyair的token，必须
+export SILICONFLOW_FASS_DEPLOY_DOMAIN=foo.bar:8192 # 设置内网域名，必须
+export BIZYAIR_GROUP_ID=123 # 设置id（ https://console.bizyair.cn/comfy-draft/exclusive-instances 的实例组id），必须
+./scripts/ready_instance.sh
+
+
+# 通过位置参数使用
+./scripts/ready_instance.sh sk-xxx foo.bar:8192 123   # 带参使用脚本，传参顺序：token，内网域名，id
+```

bizy_deploy-0.2.0/README.md

@@ -0,0 +1,133 @@
+## 安装
+## 1. 安装（二选一）
+
+```bash
+# 公有仓库
+pip install git+https://<TOKEN>@github.com/siliconflow/BizyDeploy.git
+```
+
+```bash
+# 私有仓库
+pip install git+ssh://git@github.com/siliconflow/BizyDeploy.git
+```
+
+## 使用
+
+```bash
+export SF_FAAS_TOKEN=xxxxx
+```
+
+### 场景1: 仅更新faas云函数部署 
+```
+bizy-deploy \
+  pipeline=cgr_uat \
+  service.sf_faas_token="$SF_FAAS_TOKEN" \
+  ++env.function_id=fnjfvlqpdt \
+  ++env.deployment_id=fdqd9p8te5 \
+  ++func_def.spec.comment="upgrade"
+```
+
+### 场景2: 仅更新镜像版本 (最常用)
+
+下面镜像对应云函数地址: https://cloud.siliconflow.cn/sft-d1s6t1r3jrms73f3ltpg/dedicated/functions/fnjfvlqpdt?tab=definition
+
+命令行中的 ++func_def.spec.data 对应控制台“函数定义”中的 YAML 结构 
+
+```bash
+bizy-deploy \
+  debug=false \
+  pipeline=cgr_prod \
+  service.sf_faas_token="$SF_FAAS_TOKEN" \
+  ++env.function_id=fnjfvlqpdt \
+  ++env.deployment_id=fdqd9p8te5 \
+  ++func_def.spec.comment="update image to v20251222" \
+  ++func_def.spec.data.cgrService.image="hub.6scloud.com/xxx/comfygridruntime:v20251222"
+```
+
+### 场景: 云函数模版相关操作
+
+#### 获取 {org_id}/{template_id} 对应云函数模版
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  debug=true \
+  ++pipeline.0.action='get_template' \
+  ++pipeline.0.params.org_id=d1s6t1r3jrms73f3ltpg \
+  ++pipeline.0.params.template_id=bizydraft-backend \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+```
+
+### 场景4: 从源云函数上获取配置，修改指定参数后上传到目标云函数，并部署等待就绪
+
+```bash
+bizy-deploy \
+  pipeline=cgr_uat \
+  ++pipeline.0.params.function_id=fna5m4t5ky \
+  ++env.function_id=fn1tioyopg \
+  ++env.deployment_id=fdg8skissk \
+  ++func_def.spec.data.comfyagentService.nodeRegisterConfigUrl="https://storage.bizyair.cn/config/comfyagent_node_config_chenchaonan.json" \
+  ++func_def.spec.data.comfyuiService.image="hub.6scloud.com/d1s6t1r3jrms73f3ltpg/comfyui-gpu-torch2dot5:v202512241113-feature-add-plugins-default-a8dc7ab" \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+```
+### 场景5: 得到一个函数的最新定义，创建一个新的定义，修改部署的参数后部署并等待就绪
+
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  ++pipeline.0.action='get_latest_function_definition' \
+  ++pipeline.0.params.function_id=fn1tioyopg \
+  ++pipeline.0.save_result_as='latest_func_def' \
+  ++pipeline.1.action='create_function_definition' \
+  ++pipeline.1.params.function_id=fn1tioyopg \
+  ++pipeline.1.params.merged_def='${pipe.ctx:latest_func_def}' \
+  ++pipeline.1.save_result_as="new_version" \
+  ++pipeline.2.action='deploy' \
+  ++pipeline.2.params.version='${pipe.ctx:new_version}' \
+  ++pipeline.2.params.overrides.spec.siliconServices.0.minReplicas=2 \
+  ++pipeline.2.params.overrides.spec.siliconServices.0.maxReplicas=5 \
+  ++pipeline.2.params.function_id=fn1tioyopg \
+  ++pipeline.2.params.deployment_id="fdg8skissk" \
+  ++pipeline.3.action='wait_ready' \
+  ++pipeline.3.params.function_id=fn1tioyopg \
+  ++pipeline.3.params.deployment_id=fdg8skissk \
+  service.sf_faas_token="$SF_FAAS_TOKEN"
+
+```python
+python scripts/save_template.py -tpl d1s6t1r3jrms73f3ltpg/bizydraft-backend 
+```
+
+<details open>
+<summary> Output </summary>
+
+```
+✔ Template saved: d1s6t1r3jrms73f3ltpg/bizydraft-backend -> 
+outputs/d1s6t1r3jrms73f3ltpg---bizydraft-backend.yaml
+```
+
+</details>
+
+
+#### 更新模版
+
+```bash
+bizy-deploy \
+  pipeline=faas_api_op \
+  ++pipeline.0.action='update_template' \
+  ++pipeline.0.params.name=<template_id> \
+  ++pipeline.0.params.data.files=<TemplateYamlPath> \
+  service.sf_faas_token="<SF_FAAS_TOKEN>"
+```
+
+#### 前端更新完成后清理缓存
+
+```bash
+# 通过环境变量设置使用
+export BIZYAIR_TOKEN=sk-xxx     # 设置bizyair的token，必须
+export SILICONFLOW_FASS_DEPLOY_DOMAIN=foo.bar:8192 # 设置内网域名，必须
+export BIZYAIR_GROUP_ID=123 # 设置id（ https://console.bizyair.cn/comfy-draft/exclusive-instances 的实例组id），必须
+./scripts/ready_instance.sh
+
+
+# 通过位置参数使用
+./scripts/ready_instance.sh sk-xxx foo.bar:8192 123   # 带参使用脚本，传参顺序：token，内网域名，id
+```

bizy_deploy-0.2.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bizy-deploy"
+version = "0.2.0"
+description = "BizyAir FaaS automated deployment tool"
+license = "MIT"
+authors = [{name = "SiliconFlow", email = "bizyair@siliconflow.cn"}]
+keywords = ["faas", "deploy", "siliconflow", "bizyair"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Build Tools",
+]
+requires-python = ">=3.10"
+dependencies = ["requests", "hydra-core", "loguru", "pyyaml"]
+readme = "README.md"
+
+
+[project.scripts]
+bizy-deploy = "bizy_deploy.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/siliconflow/BizyDeploy"
+Repository = "https://github.com/siliconflow/BizyDeploy"
+Issues = "https://github.com/siliconflow/BizyDeploy/issues"
+
+[project.optional-dependencies]
+scripts = ["httpx", "pillow"]
+dev = ["pytest", "pytest-cov", "build", "twine"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["*"]
+
+[tool.setuptools.package-data]
+"bizy_deploy" = ["*.yaml", "**/*.yaml", "conf/**/*"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]

bizy_deploy-0.2.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bizy_deploy-0.2.0/src/bizy_deploy/__init__.py

@@ -0,0 +1 @@
+from .core import FaasClient, save_jinja_template_yaml

bizy_deploy-0.2.0/src/bizy_deploy/cli.py

@@ -0,0 +1,79 @@
+from pathlib import Path
+
+import hydra
+from omegaconf import DictConfig, OmegaConf
+
+from .core.faas_actions import FaaSActionProvider
+from loguru import logger
+
+# 模块级别的解析器支持，允许多次创建 WorkflowEngine
+_current_engine = None
+
+
+def _pipe_ctx_resolver(key: str):
+    """OmegaConf resolver for pipe.ctx — 引用流水线上一步的结果"""
+    global _current_engine
+    if _current_engine is None:
+        raise RuntimeError("No WorkflowEngine initialized")
+    attrs = key.split(".")
+    key_first = attrs[0]
+    if key_first not in _current_engine.context:
+        logger.warning(f'"{key}" not found in pipe.ctx; using literal value')
+    ret = _current_engine.context[key_first]
+    for attr in attrs[1:]:
+        ret = getattr(ret, attr)
+    return ret
+
+
+# 注册 resolver（仅一次）
+resolver_key = "pipe.ctx"
+if not OmegaConf.has_resolver(resolver_key):
+    OmegaConf.register_new_resolver(resolver_key, _pipe_ctx_resolver, use_cache=False)
+
+
+class WorkflowEngine:
+    def __init__(self, conf: DictConfig):
+        global _current_engine
+        _current_engine = self
+        self.conf = conf
+        self.context = {}
+        self.provider = FaaSActionProvider(conf)
+
+    def run(self):
+        pipeline = self.conf.get("pipeline", [])
+        if isinstance(pipeline, DictConfig):
+            sorted_keys = sorted(pipeline.keys())
+            sorted_list = [pipeline[k] for k in sorted_keys]
+            pipeline = sorted_list
+
+        for step in pipeline:
+            action_name = step.action
+
+            params = step.get("params", {})
+            resolved_params = self._resolve_params(params)
+
+            if "output" in step:
+                resolved_params["output"] = step.output
+
+            action_func = getattr(self.provider, action_name)
+            result = action_func(**resolved_params)
+
+            if "save_result_as" in step:
+                self.context[step.save_result_as] = result
+
+    def _resolve_params(self, params):
+        resolved_params = OmegaConf.to_container(OmegaConf.create(params), resolve=True)
+        return resolved_params
+
+
+config_path = Path(__file__).parent / "conf"
+
+
+@hydra.main(version_base=None, config_path=str(config_path), config_name="config")
+def main(conf: DictConfig) -> None:
+    engine = WorkflowEngine(conf)
+    engine.run()
+
+
+if __name__ == "__main__":
+    main()

bizy_deploy-0.2.0/src/bizy_deploy/conf/config.yaml

@@ -0,0 +1,9 @@
+defaults:
+  - _self_
+  - pipeline: cgr_uat
+
+service:
+  sf_faas_token: xxxxx
+  base_url: https://busy-bear.siliconflow.cn/api/v1
+  
+debug: false

bizy_deploy-0.2.0/src/bizy_deploy/conf/pipeline/cgr_uat.yaml

@@ -0,0 +1,23 @@
+- action: "get_latest_function_definition"
+  desc: "获取生产环境函数的最新定义"
+  save_result_as: "latest_func_def"
+
+- action: "update_function_definition"
+  desc: "修改配置"
+  params:
+    latest_func_def: "${pipe.ctx:latest_func_def}"  # 使用上一步的结果
+  save_result_as: "merged_def"
+
+- action: "create_function_definition" 
+  desc: "在当前函数创建新版本定义"
+  params:
+    merged_def: "${pipe.ctx:merged_def}"
+  save_result_as: "new_version"
+
+- action: "deploy" # 部署最新版本
+  desc: "触发部署"
+  params: 
+    version: "${pipe.ctx:new_version}" # 动态引用上一步的结果
+
+- action: "wait_ready"
+  desc: "等待部署完成"

bizy_deploy-0.2.0/src/bizy_deploy/conf/pipeline/faas_api_op.yaml

@@ -0,0 +1,9 @@
+# faas_api_op pipeline - 通过 ++pipeline.N.action='action_name' 动态指定操作
+# 此文件保持纯注释（YAML 加载为 null），Hydra 的 ++ 语法会动态创建列表条目
+#
+# 用法示例:
+#   bizy-deploy pipeline=faas_api_op \
+#     ++pipeline.0.action='get_template' \
+#     ++pipeline.0.params.org_id=xxx \
+#     ++pipeline.0.params.template_id=yyy \
+#     service.sf_faas_token="$SF_FAAS_TOKEN"

bizy_deploy-0.2.0/src/bizy_deploy/core/__init__.py

@@ -0,0 +1,2 @@
+from .faas_client import FaasClient
+from .utils import save_jinja_template_yaml