diff --git a/development/deploy/overview.mdx b/development/deploy/overview.mdx index cbf3f55c87..f0fb6bfd5b 100644 --- a/development/deploy/overview.mdx +++ b/development/deploy/overview.mdx @@ -5,47 +5,131 @@ description: "Compare Comfy Cloud, managed Comfy API deployments, and self-hosti icon: "map" --- -Choose Comfy Cloud for an always-available managed ComfyUI, Comfy API for a versioned environment deployed as an endpoint, or self-hosting for infrastructure you manage. +You can run your ComfyUI Workflows on Comfy Cloud, on your own Comfy API deployment, or on a server you manage. Comfy Cloud and Comfy API run on Comfy GPUs, so they don't need a GPU on your computer. Pick the option that fits your Workflow, and start from its card. - Run workflows without creating a Build or deployment. + Run Workflows whose Custom Nodes and models are already on Comfy Cloud, with no build or deployment. - Package models and custom nodes into a managed, autoscaling endpoint. + Package Custom Nodes, models, and Python dependencies into a build, and run it as an autoscaling endpoint. - - Run ComfyUI on your own hardware, rented GPUs, or containers. + + Run ComfyUI on a machine you manage, and serve it on your network with `--listen`. -All three options run [API-format workflows](/development/api-development/workflow-api-format). Choose based on whether you want Comfy to manage the environment or want to manage it yourself. +To call any of the three from your own code, send the Workflow in [API format](/development/api-development/workflow-api-format). ## Deploy from the ComfyUI app -ComfyUI adds a **Deploy to Comfy API** entry to the **Workflow actions** menu of every top-level workflow. It is available in the local app, Comfy Cloud, and the Desktop app, and the entry is marked **NEW** in the menu. +In ComfyUI on your computer or in Comfy Desktop, the **Deploy to Comfy API** card starts a Comfy API build from the open Workflow. + + + Publishing a version is free. When its build finishes, the **Serverless build** row shows a **Deploy** button. Deploying costs storage from the moment you deploy, plus GPU time while a worker is up. The deploy dialog shows the estimated cost before you confirm. + - - In the top bar, open the **Workflow actions** menu on the workflow tab. - - - ComfyUI activates the workflow, then opens an introduction card with a short product video and a summary of the node packs, models, and node classes the workflow uses. + + In the **Top bar**, right-click the Workflow's tab. You can also click the **Workflow actions** button at the top left of the **Canvas**. + + ![Workflow actions menu open from a Workflow tab, with Deploy to Comfy API and its NEW badge below Export (API)](/images/development/deploy/deploy-to-comfy-api.png) - - Click **Deploy on Platform** to continue on [platform.comfy.org](https://platform.comfy.org). The Build Wizard there starts from an imported workflow JSON or a Comfy Desktop snapshot, and [Build sources](/development/serverless/build-sources) covers both. The card also carries a **Read the docs** link to the developer documentation. + + Select **Deploy to Comfy API**. The entry is marked **NEW**. The **Deploy to Comfy API** card opens and counts the Node packs, models, and Node classes the Workflow uses. + + ![Deploy to Comfy API card with a product video, the Node pack, model, and Node class counts, and the Deploy on Platform button](/images/development/deploy/deploy-api-ui.png) - - Click **Build with your agent** to copy a brief for the open workflow, then paste it into your coding agent. + + Click **Deploy on Platform**. The Developer Platform at [platform.comfy.org](https://platform.comfy.org) opens in a new tab. -Comfy API packages the workflow's custom nodes, models, and Python dependencies into a reproducible build, then runs it as an autoscaling endpoint. See [Comfy API](/development/serverless/quickstart) for the build and deployment flow. +On the Developer Platform, you create a build from the Workflow, publish a version, and deploy it. [Build sources](/development/serverless/build-sources) covers starting a build from a Workflow file, and the [Comfy API quickstart](/development/serverless/quickstart) covers the same flow with comfy-cli. + +## Run a deployment from the Cloud editor + +Your deployment can run Workflows in ComfyUI on Comfy Cloud, with the Custom Nodes and models in its build. + +### Create a deployment from Comfy Cloud + +On Comfy Cloud, the **Workflow actions** menu has no **Deploy to Comfy API** entry. Start from the menu next to **Run** instead: + +1. Click the menu next to **Run**. +2. Select **Create a custom deployment**, and then click **Create on Platform**. Your builds on the Developer Platform open in a new tab. + +![Run on menu open next to the Run button, with Comfy Cloud checked, the message This workspace has no deployments yet, and Create a custom deployment below it](/images/development/deploy/run-on.png) + +When your workspace already has deployments, the menu shows **Manage deployments** instead. It opens the same builds page on the Developer Platform. + +When you open a Workflow that uses Custom Nodes Comfy Cloud doesn't have, the **Run this workflow on a custom deployment** dialog lists what's missing. Click **Create on Platform** to start a build for it. + +![Comfy Cloud dialog for a Workflow with Custom Nodes Comfy Cloud doesn't have, listing the missing Nodes above the Read the docs link, the Build with your agent button, and the Create on Platform button](/images/development/deploy/run-on-custom-deployment.png) + +### Open your deployment in the Cloud editor + +1. In the deploy dialog, leave **Ready for the Cloud editor** selected if the dialog shows it. The option is on by default. If you clear **Ready for the Cloud editor**, opening the deployment in the editor later takes a minute. +2. On the deployment's page, wait for the status under its name to read **Ready**. **Open in ComfyUI** stays disabled until then. +3. Click **Open in ComfyUI**. ComfyUI on Comfy Cloud opens in a new tab and reloads onto your deployment. + +![Deployment page with the Ready status under the deployment name and the Open in ComfyUI button at the top right](/images/development/deploy/deployment-detail.jpg) + +To check where your Workflows run: + +1. Click the menu next to **Run**. +2. Find the check mark next to the deployment your Workflows run on. +3. Click **Run** to run the Workflow on it. + +![Run on menu open next to the Run button, with a check mark next to the selected deployment](/images/development/deploy/selected-deployment.jpg) + +- The menu lists every deployment in your workspace. Select a **Ready** deployment to switch to it. +- Switching reloads the editor. By default, your tabs stay open. +- This browser keeps running your Workflows on the selected deployment until you select another one. + +### Switch back to Comfy Cloud + +1. Click the menu next to **Run**. +2. Select **Comfy Cloud**. + +The editor reloads. If a Workflow has unsaved changes, a **Save your workflows before switching?** dialog opens. Click **Save and switch**, or **Switch without saving**. + +## Stop or delete a deployment + +Stop a deployment to stop its jobs, or delete it to remove it and end its storage billing. Both actions are on the deployment's page on the Developer Platform. + + + A stopped deployment runs no jobs, but its storage still bills. Delete the deployment to end storage billing. + + +To open the deployment's page: + +1. In the Developer Platform sidebar, click **Deploy**. +2. In the **Deployments** section, click the deployment's name. + +![Deployments section of the Deploy page, with each deployment's name in the leftmost column and its status in the Status column](/images/development/deploy/deployments.jpg) + +To stop the deployment: + +1. Click **Stop**. +2. In the **Stop deployment** dialog, click **Stop**. + +The status reads **Stopping**, and then **Stopped**. + +To run the deployment again: + +- Click **Start**. + + + Deleting removes the deployment and its history permanently. The build stays. + + +To delete the deployment: -### Build with your agent +1. On a stopped deployment, click **Delete**. On a running deployment, open the **More actions** menu, and then select **Delete**. +2. In the **Delete deployment** dialog, click **Delete**. -**Build with your agent** is the alternative to building by hand. It copies a plain-text brief and runs no command. ComfyUI also downloads the workflow JSON so your agent has the file to build from. In the Desktop app it does not download a separate file: the brief points at the newest snapshot in the `.launcher/snapshots` directory of the Desktop install, and importing that snapshot sends its JSON to the builder the same way. The brief names the workflow's node classes, node packs, and models, and points your agent at the current `comfy skills show comfy-build` recipe, which owns the comfy-cli commands, the version pins, the release cut, and how to read a failure. Your agent confirms with you before it uploads the workflow and again before the first cut. It then fixes one cause per cut, tells you the cause, the exact edit, and which build it is before every new cut, and stops after three cuts. A release is not a deployment, so the brief stops at a green release and deploying stays a separate decision. +The next time a browser that ran the Cloud editor on the deployment loads ComfyUI, ComfyUI runs on Comfy Cloud instead of the deleted deployment. -## Next step: run workflows against it +## Run Workflows from your application -Once a deployment is live, see [Running Workflows](/development/run-workflows/overview) to call it from your application. The [Comfy SDKs](/development/api-development/sdks) work against every deployment target; self-hosted instances additionally need the [API Proxy](/development/comfyui-server/api-proxy) to serve Comfy API v2. +When a deployment is **Ready**, see [Running Workflows](/development/run-workflows/overview) to call it from your application. The [Comfy SDKs](/development/api-development/sdks) work with Comfy Cloud and with your deployments. A self-hosted ComfyUI needs the [API Proxy](/development/comfyui-server/api-proxy) to serve Comfy API v2. diff --git a/es/development/deploy/overview.mdx b/es/development/deploy/overview.mdx index 5921ad1222..0f487e6dc2 100644 --- a/es/development/deploy/overview.mdx +++ b/es/development/deploy/overview.mdx @@ -3,54 +3,141 @@ title: "Implementar ComfyUI" sidebarTitle: "Descripción general" description: "Compara Comfy Cloud, las implementaciones gestionadas de la API de Comfy y el autoalojamiento para elegir cómo ejecutar ComfyUI." icon: "map" -translationSourceHash: ae6b628f +translationSourceHash: be91af8f translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": e8488b6f - "Deploy from the ComfyUI app": 71195be8 - "Next step: run workflows against it": 4b303213 + "_intro": cc75b9f0 + "Deploy from the ComfyUI app": 53163f19 + "Run a deployment from the Cloud editor": 9426b4cc + "Stop or delete a deployment": 9b9a173c + "Run Workflows from your application": f95d4434 --- -Elige Comfy Cloud para tener un ComfyUI administrado y siempre disponible, Comfy API para un entorno versionado desplegado como endpoint, o autoalojamiento para la infraestructura que administras tú. + +Puedes ejecutar tus flujos de trabajo de ComfyUI en Comfy Cloud, en tu propia implementación de Comfy API o en un servidor que administres. Comfy Cloud y Comfy API se ejecutan en GPU de Comfy, así que no necesitas una GPU en tu equipo. Elige la opción que encaje con tu flujo de trabajo y empieza desde su tarjeta. - Ejecuta flujos de trabajo sin crear un Build ni un despliegue. + Ejecuta flujos de trabajo cuyos nodos personalizados y modelos ya están en Comfy Cloud, sin crear un build ni un despliegue. - Empaqueta modelos y nodos personalizados en un endpoint administrado con escalado automático. + Empaqueta nodos personalizados, modelos y dependencias de Python en un build y ejecútalo como un endpoint con escalado automático. - - Ejecuta ComfyUI en tu propio hardware, en GPUs alquiladas o en contenedores. + + Ejecuta ComfyUI en una máquina que administres y sírvelo en tu red con `--listen`. -Las tres opciones ejecutan [flujos de trabajo en formato API](/es/development/api-development/workflow-api-format). Elige según si quieres que Comfy administre el entorno o si prefieres administrarlo tú mismo. +Para llamar a cualquiera de las tres desde tu propio código, envía el flujo de trabajo en [formato API](/es/development/api-development/workflow-api-format). ## Implementar desde la aplicación ComfyUI -ComfyUI agrega una entrada **Implementar en la API de Comfy** al menú **Acciones del flujo de trabajo** de cada flujo de trabajo de nivel superior. Está disponible en la aplicación local, Comfy Cloud y la aplicación Desktop, y la entrada aparece marcada como **NEW** en el menú. +En ComfyUI en tu equipo o en Comfy Desktop, la tarjeta **Deploy to Comfy API** inicia un build de Comfy API a partir del flujo de trabajo abierto. + + + Publicar una versión es gratis. Cuando termina su build, la fila **Serverless build** muestra un botón **Deploy**. Al implementar se cobra almacenamiento desde el momento del despliegue, más el tiempo de GPU mientras un worker está activo. El diálogo de despliegue muestra el coste estimado antes de confirmar. + - - En la barra superior, abre el menú **Acciones del flujo de trabajo** en la pestaña del flujo de trabajo. - - - ComfyUI activa el flujo de trabajo y luego abre una tarjeta de introducción con un video breve del producto y un resumen de los paquetes de nodos, los modelos y las clases de nodo que usa el flujo de trabajo. + + En la **Top bar**, haz clic derecho en la pestaña del flujo de trabajo. También puedes hacer clic en el botón **Workflow actions** de la esquina superior izquierda del **Canvas**. + + ![Menú Workflow actions abierto desde una pestaña de flujo de trabajo, con Deploy to Comfy API y su insignia NEW debajo de Export (API)](/images/development/deploy/deploy-to-comfy-api.png) - - Haz clic en **Implementar en la plataforma** para continuar en [platform.comfy.org](https://platform.comfy.org). El Build Wizard que encontrarás allí parte de un JSON de flujo de trabajo importado o de una instantánea de Comfy Desktop, y [Orígenes de compilación](/es/development/serverless/build-sources) cubre ambos casos. La tarjeta también incluye un enlace **Leer la documentación** a la documentación para desarrolladores. + + Selecciona **Deploy to Comfy API**. La entrada está marcada como **NEW**. Se abre la tarjeta **Deploy to Comfy API** y cuenta los paquetes de nodos, los modelos y las clases de nodo que usa el flujo de trabajo. + + ![Tarjeta Deploy to Comfy API con un vídeo del producto, los recuentos de paquetes de nodos, modelos y clases de nodo, y el botón Deploy on Platform](/images/development/deploy/deploy-api-ui.png) - - Haz clic en **Crea con tu agente** para copiar un resumen del flujo de trabajo abierto y luego pégalo en tu agente de programación. + + Haz clic en **Deploy on Platform**. Developer Platform en [platform.comfy.org](https://platform.comfy.org) se abre en una pestaña nueva. -Comfy API empaqueta los nodos personalizados, los modelos y las dependencias de Python del flujo de trabajo en una compilación reproducible y luego la ejecuta como un endpoint con escalado automático. Consulta [Comfy API](/es/development/serverless/quickstart) para conocer el flujo de compilación e implementación. +En Developer Platform, creas un build a partir del flujo de trabajo, publicas una versión y la implementas. [Orígenes de compilación](/es/development/serverless/build-sources) cubre cómo iniciar un build desde un archivo de flujo de trabajo, y la [guía rápida de Comfy API](/es/development/serverless/quickstart) cubre el mismo flujo con comfy-cli. + +## Ejecutar una implementación desde el editor de Cloud + +Tu implementación puede ejecutar flujos de trabajo en ComfyUI en Comfy Cloud, con los nodos personalizados y los modelos de su build. + +### Crear una implementación desde Comfy Cloud + +En Comfy Cloud, el menú **Workflow actions** no tiene la entrada **Deploy to Comfy API**. Empieza desde el menú junto a **Run**: + +1. Haz clic en el menú junto a **Run**. +2. Selecciona **Create a custom deployment** y luego haz clic en **Create on Platform**. Tus builds en Developer Platform se abren en una pestaña nueva. + +![Menú Run on abierto junto al botón Run, con Comfy Cloud marcado, el mensaje This workspace has no deployments yet y Create a custom deployment debajo](/images/development/deploy/run-on.png) + +Cuando tu espacio de trabajo ya tiene implementaciones, el menú muestra **Manage deployments** en su lugar. Abre la misma página de builds en Developer Platform. + +Cuando abres un flujo de trabajo que usa nodos personalizados que Comfy Cloud no tiene, el diálogo **Run this workflow on a custom deployment** enumera lo que falta. Haz clic en **Create on Platform** para iniciar un build. + +![Diálogo de Comfy Cloud para un flujo de trabajo con nodos personalizados que Comfy Cloud no tiene, con la lista de nodos faltantes encima del enlace Read the docs, el botón Build with your agent y el botón Create on Platform](/images/development/deploy/run-on-custom-deployment.png) + +### Abrir tu implementación en el editor de Cloud + +1. En el diálogo de despliegue, deja seleccionado **Ready for the Cloud editor** si el diálogo lo muestra. La opción está activada por defecto. Si desmarcas **Ready for the Cloud editor**, abrir la implementación en el editor más tarde tarda un minuto. +2. En la página de la implementación, espera a que el estado bajo su nombre diga **Ready**. **Open in ComfyUI** permanece deshabilitado hasta entonces. +3. Haz clic en **Open in ComfyUI**. ComfyUI en Comfy Cloud se abre en una pestaña nueva y se recarga en tu implementación. + +![Página de la implementación con el estado Ready bajo el nombre y el botón Open in ComfyUI arriba a la derecha](/images/development/deploy/deployment-detail.jpg) + +Para comprobar dónde se ejecutan tus flujos de trabajo: + +1. Haz clic en el menú junto a **Run**. +2. Busca la marca de verificación junto a la implementación en la que se ejecutan tus flujos de trabajo. +3. Haz clic en **Run** para ejecutar el flujo de trabajo en ella. + +![Menú Run on abierto junto al botón Run, con una marca de verificación junto a la implementación seleccionada](/images/development/deploy/selected-deployment.jpg) + +- El menú enumera cada implementación de tu espacio de trabajo. Selecciona una implementación **Ready** para cambiar a ella. +- Al cambiar se recarga el editor. Por defecto, tus pestañas permanecen abiertas. +- Este navegador sigue ejecutando tus flujos de trabajo en la implementación seleccionada hasta que elijas otra. + +### Volver a Comfy Cloud + +1. Haz clic en el menú junto a **Run**. +2. Selecciona **Comfy Cloud**. + +El editor se recarga. Si un flujo de trabajo tiene cambios sin guardar, se abre el diálogo **Save your workflows before switching?**. Haz clic en **Save and switch** o en **Switch without saving**. + +## Detener o eliminar una implementación + +Detén una implementación para parar sus trabajos, o elimínala para quitarla y terminar su facturación de almacenamiento. Ambas acciones están en la página de la implementación en Developer Platform. + + + Una implementación detenida no ejecuta trabajos, pero su almacenamiento sigue facturándose. Elimina la implementación para terminar la facturación de almacenamiento. + + +Para abrir la página de la implementación: + +1. En la barra lateral de Developer Platform, haz clic en **Deploy**. +2. En la sección **Deployments**, haz clic en el nombre de la implementación. + +![Sección Deployments de la página Deploy, con el nombre de cada implementación en la columna de la izquierda y su estado en la columna Status](/images/development/deploy/deployments.jpg) + +Para detener la implementación: + +1. Haz clic en **Stop**. +2. En el diálogo **Stop deployment**, haz clic en **Stop**. + +El estado pasa a **Stopping** y luego a **Stopped**. + +Para volver a ejecutar la implementación: + +- Haz clic en **Start**. + + + Eliminar quita la implementación y su historial de forma permanente. El build permanece. + + +Para eliminar la implementación: -### Crea con tu agente +1. En una implementación detenida, haz clic en **Delete**. En una implementación en ejecución, abre el menú **More actions** y luego selecciona **Delete**. +2. En el diálogo **Delete deployment**, haz clic en **Delete**. -**Crea con tu agente** es la alternativa a compilar a mano. Copia un resumen en texto plano y no ejecuta ningún comando. ComfyUI también descarga el JSON del flujo de trabajo para que tu agente tenga el archivo desde el que compilar. En la aplicación Desktop no descarga un archivo aparte: el resumen apunta a la instantánea más reciente del directorio `.launcher/snapshots` de la instalación de Desktop, e importar esa instantánea envía su JSON al compilador de la misma manera. El resumen indica las clases de nodo, los paquetes de nodos y los modelos del flujo de trabajo, y dirige a tu agente a la receta actual `comfy skills show comfy-build`, que se encarga de los comandos de comfy-cli, las versiones fijadas, el corte de la versión y cómo leer un fallo. Tu agente te confirma antes de subir el flujo de trabajo y de nuevo antes del primer corte. Luego corrige una causa por corte, te indica la causa, la edición exacta y qué compilación es antes de cada nuevo corte, y se detiene después de tres cortes. Una versión no es una implementación, así que el resumen se detiene en una versión verde y la implementación sigue siendo una decisión aparte. +La próxima vez que un navegador que ejecutó el editor de Cloud en la implementación cargue ComfyUI, ComfyUI se ejecutará en Comfy Cloud en lugar de en la implementación eliminada. -## Siguiente paso: ejecutar flujos de trabajo contra el despliegue +## Ejecutar flujos de trabajo desde tu aplicación -Una vez que un despliegue está activo, consulta [Ejecutar flujos de trabajo](/es/development/run-workflows/overview) para llamarlo desde tu aplicación. Los [SDK de Comfy](/es/development/api-development/sdks) funcionan con todos los objetivos de despliegue; las instancias autoalojadas además necesitan el [API Proxy](/es/development/comfyui-server/api-proxy) para servir la API v2 de Comfy. +Cuando una implementación está **Ready**, consulta [Ejecutar flujos de trabajo](/es/development/run-workflows/overview) para llamarla desde tu aplicación. Los [SDK de Comfy](/es/development/api-development/sdks) funcionan con Comfy Cloud y con tus implementaciones. Un ComfyUI autoalojado necesita el [API Proxy](/es/development/comfyui-server/api-proxy) para servir Comfy API v2. diff --git a/images/development/deploy/deploy-api-ui.png b/images/development/deploy/deploy-api-ui.png new file mode 100644 index 0000000000..e5d6f78bd3 Binary files /dev/null and b/images/development/deploy/deploy-api-ui.png differ diff --git a/images/development/deploy/deploy-to-comfy-api.png b/images/development/deploy/deploy-to-comfy-api.png new file mode 100644 index 0000000000..8d4a4d7b68 Binary files /dev/null and b/images/development/deploy/deploy-to-comfy-api.png differ diff --git a/images/development/deploy/deployment-detail.jpg b/images/development/deploy/deployment-detail.jpg new file mode 100644 index 0000000000..7daece8fd1 Binary files /dev/null and b/images/development/deploy/deployment-detail.jpg differ diff --git a/images/development/deploy/deployments.jpg b/images/development/deploy/deployments.jpg new file mode 100644 index 0000000000..582e6d8c67 Binary files /dev/null and b/images/development/deploy/deployments.jpg differ diff --git a/images/development/deploy/run-on-custom-deployment.png b/images/development/deploy/run-on-custom-deployment.png new file mode 100644 index 0000000000..3621093223 Binary files /dev/null and b/images/development/deploy/run-on-custom-deployment.png differ diff --git a/images/development/deploy/run-on.png b/images/development/deploy/run-on.png new file mode 100644 index 0000000000..d1e9354664 Binary files /dev/null and b/images/development/deploy/run-on.png differ diff --git a/images/development/deploy/selected-deployment.jpg b/images/development/deploy/selected-deployment.jpg new file mode 100644 index 0000000000..1334319c04 Binary files /dev/null and b/images/development/deploy/selected-deployment.jpg differ diff --git a/ja/development/deploy/overview.mdx b/ja/development/deploy/overview.mdx index c7011780f1..9a111a6242 100644 --- a/ja/development/deploy/overview.mdx +++ b/ja/development/deploy/overview.mdx @@ -3,55 +3,141 @@ title: "ComfyUI のデプロイ" sidebarTitle: "概要" description: "Comfy Cloud、マネージド Comfy API デプロイ、セルフホストを比較して、ComfyUI の実行方法を選択します。" icon: "map" -translationSourceHash: ae6b628f +translationSourceHash: be91af8f translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": e8488b6f - "Deploy from the ComfyUI app": 71195be8 - "Next step: run workflows against it": 4b303213 + "_intro": cc75b9f0 + "Deploy from the ComfyUI app": 53163f19 + "Run a deployment from the Cloud editor": 9426b4cc + "Stop or delete a deployment": 9b9a173c + "Run Workflows from your application": f95d4434 --- -常時利用可能なマネージド ComfyUI には Comfy Cloud を、エンドポイントとしてデプロイするバージョン管理された環境には Comfy API を、自身で管理するインフラストラクチャにはセルフホストを選びます。 +ComfyUI ワークフローは、Comfy Cloud、自身の Comfy API デプロイ、または自身で管理するサーバー上で実行できます。Comfy Cloud と Comfy API は Comfy GPU 上で動作するため、お使いのパソコンに GPU は不要です。ワークフローに合う選択肢を選び、そのカードから始めてください。 - Build やデプロイを作成せずにワークフローを実行します。 + Comfy Cloud にすでにあるカスタムノードとモデルのワークフローを、ビルドやデプロイなしで実行します。 - モデルとカスタムノードをパッケージ化し、マネージドで自動スケーリングするエンドポイントとして提供します。 + カスタムノード、モデル、Python 依存関係をビルドにパッケージ化し、自動スケーリングするエンドポイントとして実行します。 - 自身のハードウェア、レンタル GPU、またはコンテナ上で ComfyUI を実行します。 + 自身で管理するマシン上で ComfyUI を実行し、`--listen` でネットワークに公開します。 -3 つの選択肢はいずれも [API フォーマットのワークフロー](/ja/development/api-development/workflow-api-format)を実行します。Comfy に環境を管理させるか、自身で管理するかに基づいて選択してください。 +3 つのいずれかを自身のコードから呼び出すには、[API フォーマット](/ja/development/api-development/workflow-api-format)のワークフローを送信します。 ## ComfyUI アプリからのデプロイ -ComfyUI は、すべてのトップレベルのワークフローの **Workflow actions** メニューに **Deploy to Comfy API** エントリを追加します。ローカルアプリ、Comfy Cloud、デスクトップアプリで利用でき、メニューでは **NEW** と表示されます。 +パソコン上の ComfyUI または Comfy Desktop では、**Deploy to Comfy API** カードが開いているワークフローから Comfy API ビルドを開始します。 + + + バージョンの公開は無料です。ビルドが完了すると、**Serverless build** 行に **Deploy** ボタンが表示されます。デプロイすると、デプロイした時点からストレージ料金が発生し、ワーカーが稼働している間は GPU 時間も課金されます。確認前に、デプロイダイアログに見積もり料金が表示されます。 + - - 上部バーのワークフロータブで **Workflow actions** メニューを開きます。 + + **Top bar** で、ワークフローのタブを右クリックします。**Canvas** 左上の **Workflow actions** ボタンをクリックしても構いません。 + + ![ワークフロータブから開いた Workflow actions メニュー。Export (API) の下に Deploy to Comfy API とその NEW バッジ](/images/development/deploy/deploy-to-comfy-api.png) - ComfyUI はワークフローを有効化したあと、短い製品動画と、そのワークフローが使うノードパック、モデル、ノードクラスの要約を含む紹介カードを開きます。 - - - **Deploy on Platform** をクリックして [platform.comfy.org](https://platform.comfy.org) で続行します。プラットフォームの Build Wizard は、インポートしたワークフロー JSON か Comfy Desktop のスナップショットから始めます。どちらの手順も[ビルドソース](/ja/development/serverless/build-sources)にまとめています。カードには開発者ドキュメントへの **Read the docs** リンクもあります。 + **Deploy to Comfy API** を選択します。エントリには **NEW** と表示されます。**Deploy to Comfy API** カードが開き、ワークフローが使うノードパック、モデル、ノードクラスを集計します。 + + ![製品動画、ノードパック/モデル/ノードクラスの件数、Deploy on Platform ボタンがある Deploy to Comfy API カード](/images/development/deploy/deploy-api-ui.png) - - **Build with your agent** をクリックすると、開いているワークフローのブリーフがコピーされるので、コーディングエージェントに貼り付けます。 + + **Deploy on Platform** をクリックします。Developer Platform([platform.comfy.org](https://platform.comfy.org))が新しいタブで開きます。 -Comfy API はワークフローのカスタムノード、モデル、Python 依存関係を再現可能なビルドにパッケージ化し、自動スケーリングするエンドポイントとして実行します。ビルドとデプロイの流れは [Comfy API](/ja/development/serverless/quickstart) を参照してください。 +Developer Platform では、ワークフローからビルドを作成し、バージョンを公開してデプロイします。[ビルドソース](/ja/development/serverless/build-sources)ではワークフローファイルからビルドを開始する方法を、[Comfy API クイックスタート](/ja/development/serverless/quickstart)では comfy-cli による同じ流れを扱います。 + +## Cloud エディターからデプロイを実行する + +デプロイは、そのビルドに含まれるカスタムノードとモデルを使い、Comfy Cloud 上の ComfyUI でワークフローを実行できます。 + +### Comfy Cloud からデプロイを作成する + +Comfy Cloud では、**Workflow actions** メニューに **Deploy to Comfy API** エントリはありません。代わりに **Run** の横のメニューから始めます。 + +1. **Run** の横のメニューをクリックします。 +2. **Create a custom deployment** を選択し、**Create on Platform** をクリックします。Developer Platform 上のビルドが新しいタブで開きます。 + +![Run ボタン横で開いた Run on メニュー。Comfy Cloud がチェックされ、This workspace has no deployments yet と Create a custom deployment が表示されている](/images/development/deploy/run-on.png) + +ワークスペースにすでにデプロイがある場合、メニューには代わりに **Manage deployments** が表示されます。同じ Developer Platform のビルドページが開きます。 + +Comfy Cloud にないカスタムノードを使うワークフローを開くと、**Run this workflow on a custom deployment** ダイアログが不足分を一覧表示します。**Create on Platform** をクリックしてビルドを開始します。 + +![Comfy Cloud にないカスタムノードを含むワークフロー用のダイアログ。Read the docs リンク、Build with your agent ボタン、Create on Platform ボタンの上に不足ノードを一覧表示](/images/development/deploy/run-on-custom-deployment.png) + +### Cloud エディターでデプロイを開く + +1. デプロイダイアログで **Ready for the Cloud editor** が表示されている場合は、選択したままにします。このオプションはデフォルトでオンです。**Ready for the Cloud editor** をオフにすると、あとからエディターでデプロイを開くのに約 1 分かかります。 +2. デプロイのページで、名前の下のステータスが **Ready** になるまで待ちます。それまで **Open in ComfyUI** は無効のままです。 +3. **Open in ComfyUI** をクリックします。Comfy Cloud 上の ComfyUI が新しいタブで開き、デプロイに切り替わります。 + +![デプロイ名の下に Ready ステータス、右上に Open in ComfyUI ボタンがあるデプロイページ](/images/development/deploy/deployment-detail.jpg) + +ワークフローの実行先を確認するには: + +1. **Run** の横のメニューをクリックします。 +2. ワークフローが実行されているデプロイの横のチェックマークを確認します。 +3. **Run** をクリックして、そのデプロイでワークフローを実行します。 + +![Run ボタン横で開いた Run on メニュー。選択中のデプロイの横にチェックマーク](/images/development/deploy/selected-deployment.jpg) + +- メニューにはワークスペース内のすべてのデプロイが一覧表示されます。**Ready** のデプロイを選択して切り替えます。 +- 切り替えるとエディターが再読み込みされます。デフォルトではタブは開いたままです。 +- このブラウザーは、別のデプロイを選択するまで、選択したデプロイでワークフローを実行し続けます。 + +### Comfy Cloud に戻す + +1. **Run** の横のメニューをクリックします。 +2. **Comfy Cloud** を選択します。 + +エディターが再読み込みされます。ワークフローに未保存の変更がある場合は、**Save your workflows before switching?** ダイアログが開きます。**Save and switch**、または **Switch without saving** をクリックします。 + +## デプロイの停止または削除 + +デプロイを停止するとジョブが止まり、削除するとデプロイが取り除かれストレージ課金が終了します。どちらの操作も Developer Platform 上のデプロイページにあります。 + + + 停止したデプロイはジョブを実行しませんが、ストレージは引き続き課金されます。ストレージ課金を終了するにはデプロイを削除してください。 + + +デプロイのページを開くには: + +1. Developer Platform のサイドバーで **Deploy** をクリックします。 +2. **Deployments** セクションでデプロイ名をクリックします。 + +![Deploy ページの Deployments セクション。左端の列に各デプロイ名、Status 列にステータス](/images/development/deploy/deployments.jpg) + +デプロイを停止するには: + +1. **Stop** をクリックします。 +2. **Stop deployment** ダイアログで **Stop** をクリックします。 + +ステータスは **Stopping** になり、その後 **Stopped** になります。 + +デプロイを再度実行するには: + +- **Start** をクリックします。 + + + 削除するとデプロイとその履歴が完全に取り除かれます。ビルドは残ります。 + + +デプロイを削除するには: -### エージェントでビルドする +1. 停止したデプロイでは **Delete** をクリックします。実行中のデプロイでは **More actions** メニューを開き、**Delete** を選択します。 +2. **Delete deployment** ダイアログで **Delete** をクリックします。 -**Build with your agent** は手作業でビルドする代わりの方法です。コマンドは実行せず、プレーンテキストのブリーフをコピーするだけです。ComfyUI はワークフローの JSON もダウンロードし、エージェントがビルドに使えるようにします。デスクトップアプリでは別のファイルをダウンロードせず、ブリーフはデスクトップ版のインストール先にある `.launcher/snapshots` の最新スナップショットを指します。そのスナップショットをインポートすると、ダウンロードしたワークフローと同じように JSON がビルダーに送られます。ブリーフにはワークフローのノードクラス、ノードパック、モデルが記載され、エージェントは現在の `comfy skills show comfy-build` レシピに従います。comfy-cli のコマンド、バージョンの固定、リリースのカット、失敗の読み方はこのレシピが担当します。エージェントはワークフローのアップロード前と最初のカット前にあなたに確認します。その後は 1 回のカットにつき 1 つの原因だけを修正し、新しいカットのたびに原因、具体的な編集、何回目のビルドかを伝え、3 回のカットで停止します。release はデプロイではないため、ブリーフは green な release で止まり、デプロイは別の判断になります。 +そのデプロイ上で Cloud エディターを実行していたブラウザーが次に ComfyUI を読み込むと、削除されたデプロイではなく Comfy Cloud 上で ComfyUI が実行されます。 -## 次のステップ: デプロイ先でワークフローを実行する +## アプリケーションからワークフローを実行する -デプロイが稼働したら、[ワークフローの実行](/ja/development/run-workflows/overview)を参照して、アプリケーションから呼び出してください。[Comfy SDK](/ja/development/api-development/sdks) はすべてのデプロイターゲットに対して動作します。セルフホストインスタンスでは、Comfy API v2 の提供に [API Proxy](/ja/development/comfyui-server/api-proxy) が必要です。 +デプロイが **Ready** になったら、[ワークフローの実行](/ja/development/run-workflows/overview)を参照してアプリケーションから呼び出してください。[Comfy SDK](/ja/development/api-development/sdks) は Comfy Cloud と自身のデプロイで動作します。セルフホストの ComfyUI では、Comfy API v2 の提供に [API Proxy](/ja/development/comfyui-server/api-proxy) が必要です。 diff --git a/ko/development/deploy/overview.mdx b/ko/development/deploy/overview.mdx index d268e072ea..7d72ce17ea 100644 --- a/ko/development/deploy/overview.mdx +++ b/ko/development/deploy/overview.mdx @@ -3,55 +3,141 @@ title: "ComfyUI 배포하기" sidebarTitle: "개요" description: "Comfy Cloud, 관리형 Comfy API 배포, 자체 호스팅을 비교하여 ComfyUI 실행 방식을 선택하세요." icon: "map" -translationSourceHash: ae6b628f +translationSourceHash: be91af8f translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": e8488b6f - "Deploy from the ComfyUI app": 71195be8 - "Next step: run workflows against it": 4b303213 + "_intro": cc75b9f0 + "Deploy from the ComfyUI app": 53163f19 + "Run a deployment from the Cloud editor": 9426b4cc + "Stop or delete a deployment": 9b9a173c + "Run Workflows from your application": f95d4434 --- -항상 사용할 수 있는 관리형 ComfyUI가 필요하면 Comfy Cloud를, 엔드포인트로 배포되는 버전 지정 환경이 필요하면 Comfy API를, 직접 관리하는 인프라가 필요하면 자체 호스팅을 선택하세요. +ComfyUI 워크플로는 Comfy Cloud, 자신의 Comfy API 배포, 또는 직접 관리하는 서버에서 실행할 수 있습니다. Comfy Cloud와 Comfy API는 Comfy GPU에서 실행되므로 컴퓨터에 GPU가 필요하지 않습니다. 워크플로에 맞는 옵션을 고르고 해당 카드부터 시작하세요. - Build나 배포를 생성하지 않고 워크플로를 실행합니다. + Comfy Cloud에 이미 있는 커스텀 노드와 모델의 워크플로를 빌드나 배포 없이 실행합니다. - 모델과 커스텀 노드를 관리형 오토스케일링 엔드포인트로 패키징합니다. + 커스텀 노드, 모델, Python 종속성을 빌드로 패키징하고 오토스케일링 엔드포인트로 실행합니다. - 자체 하드웨어, 대여한 GPU 또는 컨테이너에서 ComfyUI를 실행합니다. + 직접 관리하는 머신에서 ComfyUI를 실행하고 `--listen`으로 네트워크에 제공합니다. -세 가지 옵션 모두 [API 형식 워크플로](/ko/development/api-development/workflow-api-format)를 실행합니다. Comfy가 환경을 관리하기를 원하는지, 직접 관리하기를 원하는지에 따라 선택하세요. +세 가지 중 하나를 자신의 코드에서 호출하려면 [API 형식](/ko/development/api-development/workflow-api-format) 워크플로를 전송하세요. ## ComfyUI 앱에서 배포하기 -ComfyUI는 모든 최상위 워크플로의 **Workflow actions** 메뉴에 **Deploy to Comfy API** 항목을 추가합니다. 로컬 앱, Comfy Cloud, 데스크톱 앱에서 사용할 수 있으며, 메뉴에서 **NEW** 표시가 붙습니다. +컴퓨터의 ComfyUI 또는 Comfy Desktop에서 **Deploy to Comfy API** 카드는 열려 있는 워크플로로 Comfy API 빌드를 시작합니다. + + + 버전 게시에는 요금이 없습니다. 빌드가 끝나면 **Serverless build** 행에 **Deploy** 버튼이 나타납니다. 배포하면 배포한 순간부터 스토리지 요금이 발생하고, 워커가 가동 중일 때는 GPU 시간도 청구됩니다. 확인하기 전에 배포 대화 상자에 예상 비용이 표시됩니다. + - - 상단 바의 워크플로 탭에서 **Workflow actions** 메뉴를 엽니다. + + **Top bar**에서 워크플로 탭을 마우스 오른쪽 버튼으로 클릭합니다. **Canvas** 왼쪽 위의 **Workflow actions** 버튼을 클릭해도 됩니다. + + ![워크플로 탭에서 연 Workflow actions 메뉴. Export (API) 아래에 Deploy to Comfy API와 NEW 배지](/images/development/deploy/deploy-to-comfy-api.png) - ComfyUI가 워크플로를 활성화한 다음, 짧은 제품 영상과 함께 해당 워크플로가 사용하는 노드 팩, 모델, 노드 클래스 요약이 담긴 소개 카드를 엽니다. - - - **Deploy on Platform**을 클릭해 [platform.comfy.org](https://platform.comfy.org)에서 계속합니다. 플랫폼의 Build Wizard는 가져온 워크플로 JSON 또는 Comfy Desktop 스냅샷에서 시작하며, 두 방법은 [빌드 소스](/ko/development/serverless/build-sources)에 정리되어 있습니다. 카드에는 개발자 문서로 이동하는 **Read the docs** 링크도 있습니다. + **Deploy to Comfy API**를 선택합니다. 항목에는 **NEW** 표시가 있습니다. **Deploy to Comfy API** 카드가 열리고 워크플로가 사용하는 노드 팩, 모델, 노드 클래스를 집계합니다. + + ![제품 영상, 노드 팩/모델/노드 클래스 수, Deploy on Platform 버튼이 있는 Deploy to Comfy API 카드](/images/development/deploy/deploy-api-ui.png) - - **Build with your agent**를 클릭하면 열려 있는 워크플로의 브리프가 복사되며, 이를 코딩 에이전트에 붙여 넣습니다. + + **Deploy on Platform**을 클릭합니다. Developer Platform([platform.comfy.org](https://platform.comfy.org))이 새 탭에서 열립니다. -Comfy API는 워크플로의 커스텀 노드, 모델, Python 종속성을 재현 가능한 빌드로 패키징한 다음, 오토스케일링 엔드포인트로 실행합니다. 빌드와 배포 흐름은 [Comfy API](/ko/development/serverless/quickstart)를 참고하세요. +Developer Platform에서는 워크플로에서 빌드를 만들고, 버전을 게시한 뒤 배포합니다. [빌드 소스](/ko/development/serverless/build-sources)는 워크플로 파일에서 빌드를 시작하는 방법을, [Comfy API 빠른 시작](/ko/development/serverless/quickstart)은 comfy-cli로 같은 흐름을 다룹니다. + +## Cloud 편집기에서 배포 실행하기 + +배포는 빌드에 포함된 커스텀 노드와 모델을 사용해 Comfy Cloud의 ComfyUI에서 워크플로를 실행할 수 있습니다. + +### Comfy Cloud에서 배포 만들기 + +Comfy Cloud에서는 **Workflow actions** 메뉴에 **Deploy to Comfy API** 항목이 없습니다. 대신 **Run** 옆 메뉴에서 시작하세요. + +1. **Run** 옆 메뉴를 클릭합니다. +2. **Create a custom deployment**를 선택한 다음 **Create on Platform**을 클릭합니다. Developer Platform의 빌드가 새 탭에서 열립니다. + +![Run 버튼 옆에서 연 Run on 메뉴. Comfy Cloud가 선택되어 있고 This workspace has no deployments yet와 Create a custom deployment가 표시됨](/images/development/deploy/run-on.png) + +워크스페이스에 이미 배포가 있으면 메뉴에 **Manage deployments**가 대신 표시됩니다. 같은 Developer Platform 빌드 페이지가 열립니다. + +Comfy Cloud에 없는 커스텀 노드를 쓰는 워크플로를 열면 **Run this workflow on a custom deployment** 대화 상자가 빠진 항목을 나열합니다. **Create on Platform**을 클릭해 빌드를 시작하세요. + +![Comfy Cloud에 없는 커스텀 노드가 있는 워크플로용 Comfy Cloud 대화 상자. Read the docs 링크, Build with your agent 버튼, Create on Platform 버튼 위에 빠진 노드 목록](/images/development/deploy/run-on-custom-deployment.png) + +### Cloud 편집기에서 배포 열기 + +1. 배포 대화 상자에서 **Ready for the Cloud editor**가 보이면 선택된 상태로 둡니다. 이 옵션은 기본적으로 켜져 있습니다. **Ready for the Cloud editor**를 해제하면 나중에 편집기에서 배포를 여는 데 약 1분이 걸립니다. +2. 배포 페이지에서 이름 아래 상태가 **Ready**가 될 때까지 기다립니다. 그전까지 **Open in ComfyUI**는 비활성화된 채로 있습니다. +3. **Open in ComfyUI**를 클릭합니다. Comfy Cloud의 ComfyUI가 새 탭에서 열리고 배포로 다시 로드됩니다. + +![배포 이름 아래에 Ready 상태, 오른쪽 위에 Open in ComfyUI 버튼이 있는 배포 페이지](/images/development/deploy/deployment-detail.jpg) + +워크플로가 어디서 실행되는지 확인하려면: + +1. **Run** 옆 메뉴를 클릭합니다. +2. 워크플로가 실행 중인 배포 옆의 체크 표시를 찾습니다. +3. **Run**을 클릭해 해당 배포에서 워크플로를 실행합니다. + +![Run 버튼 옆에서 연 Run on 메뉴. 선택한 배포 옆에 체크 표시](/images/development/deploy/selected-deployment.jpg) + +- 메뉴에는 워크스페이스의 모든 배포가 나열됩니다. **Ready** 배포를 선택해 전환하세요. +- 전환하면 편집기가 다시 로드됩니다. 기본적으로 탭은 열린 채로 유지됩니다. +- 이 브라우저는 다른 배포를 선택할 때까지 선택한 배포에서 워크플로를 계속 실행합니다. + +### Comfy Cloud로 다시 전환하기 + +1. **Run** 옆 메뉴를 클릭합니다. +2. **Comfy Cloud**를 선택합니다. + +편집기가 다시 로드됩니다. 워크플로에 저장하지 않은 변경 사항이 있으면 **Save your workflows before switching?** 대화 상자가 열립니다. **Save and switch** 또는 **Switch without saving**을 클릭하세요. + +## 배포 중지 또는 삭제 + +배포를 중지하면 작업이 멈추고, 삭제하면 배포가 제거되며 스토리지 요금이 종료됩니다. 두 작업 모두 Developer Platform의 배포 페이지에 있습니다. + + + 중지된 배포는 작업을 실행하지 않지만 스토리지는 계속 청구됩니다. 스토리지 요금을 끝내려면 배포를 삭제하세요. + + +배포 페이지를 열려면: + +1. Developer Platform 사이드바에서 **Deploy**를 클릭합니다. +2. **Deployments** 섹션에서 배포 이름을 클릭합니다. + +![Deploy 페이지의 Deployments 섹션. 가장 왼쪽 열에 각 배포 이름, Status 열에 상태](/images/development/deploy/deployments.jpg) + +배포를 중지하려면: + +1. **Stop**을 클릭합니다. +2. **Stop deployment** 대화 상자에서 **Stop**을 클릭합니다. + +상태가 **Stopping**으로 표시된 다음 **Stopped**가 됩니다. + +배포를 다시 실행하려면: + +- **Start**를 클릭합니다. + + + 삭제하면 배포와 그 기록이 영구적으로 제거됩니다. 빌드는 남습니다. + + +배포를 삭제하려면: -### 에이전트로 빌드하기 +1. 중지된 배포에서는 **Delete**를 클릭합니다. 실행 중인 배포에서는 **More actions** 메뉴를 연 다음 **Delete**를 선택합니다. +2. **Delete deployment** 대화 상자에서 **Delete**를 클릭합니다. -**Build with your agent**는 직접 빌드하는 대신 쓰는 방법입니다. 명령을 실행하지 않고 일반 텍스트 브리프만 복사합니다. ComfyUI는 워크플로 JSON도 내려받아 에이전트가 빌드할 파일을 갖게 합니다. 데스크톱 앱에서는 별도 파일을 내려받지 않고, 브리프가 데스크톱 설치 경로의 `.launcher/snapshots`에 있는 최신 스냅샷을 가리킵니다. 그 스냅샷을 가져오면 내려받은 워크플로와 마찬가지로 JSON이 빌더로 전송됩니다. 브리프에는 워크플로의 노드 클래스, 노드 팩, 모델이 나열되고, 에이전트는 현재 `comfy skills show comfy-build` 레시피를 따릅니다. comfy-cli 명령, 버전 고정, 릴리스 컷, 실패 확인 방법은 이 레시피가 담당합니다. 에이전트는 워크플로 업로드 전과 첫 컷 전에 사용자에게 확인합니다. 이후에는 컷마다 원인 하나만 수정하고, 새 컷 전마다 원인과 구체적인 수정 내용, 몇 번째 빌드인지 알려 주며, 세 번의 컷에서 멈춥니다. 릴리스는 배포가 아니므로 브리프는 green 릴리스에서 멈추고, 배포 여부는 별도의 결정입니다. +해당 배포에서 Cloud 편집기를 실행했던 브라우저가 다음에 ComfyUI를 로드하면, 삭제된 배포가 아니라 Comfy Cloud에서 ComfyUI가 실행됩니다. -## 다음 단계: 배포한 환경에서 워크플로 실행 +## 애플리케이션에서 워크플로 실행하기 -배포가 실행 중이 되면 [워크플로 실행](/ko/development/run-workflows/overview)을 참고하여 애플리케이션에서 호출하세요. [Comfy SDK](/ko/development/api-development/sdks)는 모든 배포 대상에서 작동하며, 자체 호스팅 인스턴스는 Comfy API v2를 제공하기 위해 [API 프록시](/ko/development/comfyui-server/api-proxy)가 필요합니다. +배포가 **Ready**이면 [워크플로 실행](/ko/development/run-workflows/overview)을 참고하여 애플리케이션에서 호출하세요. [Comfy SDK](/ko/development/api-development/sdks)는 Comfy Cloud와 자신의 배포에서 작동합니다. 자체 호스팅 ComfyUI는 Comfy API v2를 제공하려면 [API 프록시](/ko/development/comfyui-server/api-proxy)가 필요합니다. diff --git a/zh/development/deploy/overview.mdx b/zh/development/deploy/overview.mdx index 60857c159e..9acca2c2e1 100644 --- a/zh/development/deploy/overview.mdx +++ b/zh/development/deploy/overview.mdx @@ -3,55 +3,141 @@ title: "部署 ComfyUI" sidebarTitle: "概述" description: "对比 Comfy Cloud、托管式 Comfy API 部署与自托管,选择运行 ComfyUI 的方式。" icon: "map" -translationSourceHash: ae6b628f +translationSourceHash: be91af8f translationFrom: development/deploy/overview.mdx translationBlockHashes: - "_intro": e8488b6f - "Deploy from the ComfyUI app": 71195be8 - "Next step: run workflows against it": 4b303213 + "_intro": cc75b9f0 + "Deploy from the ComfyUI app": 53163f19 + "Run a deployment from the Cloud editor": 9426b4cc + "Stop or delete a deployment": 9b9a173c + "Run Workflows from your application": f95d4434 --- -选择 Comfy Cloud,获得始终可用的托管式 ComfyUI;选择 Comfy API,获得部署为端点的带版本号环境;或者选择自托管,使用由你自己管理的基础设施。 +你可以在 Comfy Cloud、自己的 Comfy API 部署,或自己管理的服务器上运行 ComfyUI 工作流。Comfy Cloud 和 Comfy API 运行在 Comfy GPU 上,因此你的电脑不需要 GPU。按工作流选择合适方案,从对应卡片开始。 - 无需创建 Build 或部署即可运行工作流。 + 运行 Comfy Cloud 上已有自定义节点和模型的工作流,无需构建或部署。 - 将模型和自定义节点打包为托管式、可自动扩缩容的端点。 + 将自定义节点、模型和 Python 依赖打包为构建,并以可自动扩缩容的端点运行。 - 在你自己的硬件、租用的 GPU 或容器中运行 ComfyUI。 + 在你管理的机器上运行 ComfyUI,并用 `--listen` 在网络中提供服务。 -这三种方案都运行 [API 格式工作流](/zh/development/api-development/workflow-api-format)。你可以根据希望由 Comfy 管理环境,还是由自己管理环境来做出选择。 +要从自己的代码调用这三种方案中的任意一种,请发送 [API 格式](/zh/development/api-development/workflow-api-format) 的工作流。 ## 从 ComfyUI 应用中部署 -ComfyUI 在每个顶层工作流的 **Workflow actions** 菜单中提供 **Deploy to Comfy API** 入口。本地应用、Comfy Cloud 和桌面版都可以使用,该入口在菜单中标记为 **NEW**。 +在电脑上的 ComfyUI 或 Comfy Desktop 中,**Deploy to Comfy API** 卡片会从当前打开的工作流启动 Comfy API 构建。 + + + 发布版本免费。构建完成后,**Serverless build** 行会出现 **Deploy** 按钮。部署后从部署那一刻起产生存储费用,以及 worker 运行期间的 GPU 时间费用。确认前,部署对话框会显示预估费用。 + - - 在顶部栏中,打开工作流标签页上的 **Workflow actions** 菜单。 + + 在 **Top bar** 中,右键点击工作流标签页。也可以点击 **Canvas** 左上角的 **Workflow actions** 按钮。 + + ![从工作流标签页打开的 Workflow actions 菜单,Export (API) 下方是 Deploy to Comfy API 及其 NEW 徽章](/images/development/deploy/deploy-to-comfy-api.png) - ComfyUI 会先激活该工作流,然后打开一张介绍卡片,其中包含产品短视频,以及该工作流所用节点包、模型和节点类的摘要。 - - - 点击 **Deploy on Platform**,在 [platform.comfy.org](https://platform.comfy.org) 上继续。平台上的 Build Wizard 以导入的工作流 JSON 或 Comfy Desktop 快照为起点,两种来源见[构建来源](/zh/development/serverless/build-sources)。卡片上还有一个 **Read the docs** 链接,指向开发者文档。 + 选择 **Deploy to Comfy API**。该入口标有 **NEW**。**Deploy to Comfy API** 卡片会打开,并统计工作流使用的节点包、模型和节点类。 + + ![Deploy to Comfy API 卡片,含产品视频、节点包/模型/节点类计数,以及 Deploy on Platform 按钮](/images/development/deploy/deploy-api-ui.png) - - 点击 **Build with your agent**,复制当前工作流的说明,然后粘贴到你的编码代理中。 + + 点击 **Deploy on Platform**。Developer Platform([platform.comfy.org](https://platform.comfy.org))会在新标签页中打开。 -Comfy API 会把工作流的自定义节点、模型和 Python 依赖打包为可复现的构建,然后作为可自动扩缩容的端点运行。构建与部署流程见 [Comfy API](/zh/development/serverless/quickstart)。 +在 Developer Platform 上,你可以从工作流创建构建、发布版本并部署。[构建来源](/zh/development/serverless/build-sources)介绍如何从工作流文件启动构建,[Comfy API 快速开始](/zh/development/serverless/quickstart)介绍使用 comfy-cli 的同一流程。 + +## 从 Cloud 编辑器运行部署 + +你的部署可以在 Comfy Cloud 上的 ComfyUI 中运行工作流,并使用其构建中的自定义节点和模型。 + +### 从 Comfy Cloud 创建部署 + +在 Comfy Cloud 上,**Workflow actions** 菜单没有 **Deploy to Comfy API** 入口。请改为从 **Run** 旁边的菜单开始: + +1. 点击 **Run** 旁边的菜单。 +2. 选择 **Create a custom deployment**,然后点击 **Create on Platform**。你在 Developer Platform 上的构建会在新标签页中打开。 + +![Run 按钮旁打开的 Run on 菜单,勾选了 Comfy Cloud,显示 This workspace has no deployments yet,下方是 Create a custom deployment](/images/development/deploy/run-on.png) + +当工作区已有部署时,菜单会改为显示 **Manage deployments**。它会打开 Developer Platform 上的同一构建页面。 + +当你打开使用了 Comfy Cloud 没有的自定义节点的工作流时,**Run this workflow on a custom deployment** 对话框会列出缺失项。点击 **Create on Platform** 为其启动构建。 + +![Comfy Cloud 对话框,针对含 Comfy Cloud 没有的自定义节点的工作流,在 Read the docs 链接、Build with your agent 按钮和 Create on Platform 按钮上方列出缺失节点](/images/development/deploy/run-on-custom-deployment.png) + +### 在 Cloud 编辑器中打开你的部署 + +1. 在部署对话框中,如果显示 **Ready for the Cloud editor**,请保持选中。该选项默认开启。如果取消 **Ready for the Cloud editor**,之后在编辑器中打开该部署会多花大约一分钟。 +2. 在部署页面上,等待名称下方的状态变为 **Ready**。在此之前 **Open in ComfyUI** 保持禁用。 +3. 点击 **Open in ComfyUI**。Comfy Cloud 上的 ComfyUI 会在新标签页中打开,并重新加载到你的部署。 + +![部署页面,部署名称下方显示 Ready 状态,右上角是 Open in ComfyUI 按钮](/images/development/deploy/deployment-detail.jpg) + +要查看工作流在哪里运行: + +1. 点击 **Run** 旁边的菜单。 +2. 找到工作流所运行的部署旁的对勾。 +3. 点击 **Run**,在该部署上运行工作流。 + +![Run 按钮旁打开的 Run on 菜单,所选部署旁有对勾](/images/development/deploy/selected-deployment.jpg) + +- 菜单会列出工作区中的每个部署。选择一个 **Ready** 部署即可切换到它。 +- 切换会重新加载编辑器。默认情况下,你的标签页会保持打开。 +- 此浏览器会继续在所选部署上运行工作流,直到你选择另一个部署。 + +### 切换回 Comfy Cloud + +1. 点击 **Run** 旁边的菜单。 +2. 选择 **Comfy Cloud**。 + +编辑器会重新加载。如果工作流有未保存的更改,会打开 **Save your workflows before switching?** 对话框。点击 **Save and switch**,或 **Switch without saving**。 + +## 停止或删除部署 + +停止部署可停止其任务,删除部署可移除它并结束其存储计费。这两个操作都在 Developer Platform 上的部署页面中。 + + + 已停止的部署不会运行任务,但仍会产生存储费用。删除部署才能结束存储计费。 + + +打开部署页面: + +1. 在 Developer Platform 侧边栏中,点击 **Deploy**。 +2. 在 **Deployments** 部分,点击部署名称。 + +![Deploy 页面的 Deployments 部分,最左列是各部署名称,Status 列是其状态](/images/development/deploy/deployments.jpg) + +停止部署: + +1. 点击 **Stop**。 +2. 在 **Stop deployment** 对话框中,点击 **Stop**。 + +状态会显示为 **Stopping**,然后变为 **Stopped**。 + +再次运行部署: + +- 点击 **Start**。 + + + 删除会永久移除部署及其历史。构建会保留。 + + +删除部署: -### 使用代理来构建 +1. 在已停止的部署上,点击 **Delete**。在运行中的部署上,打开 **More actions** 菜单,然后选择 **Delete**。 +2. 在 **Delete deployment** 对话框中,点击 **Delete**。 -**Build with your agent** 是不手动构建的替代方案。它只复制一段纯文本说明,不会执行任何命令。ComfyUI 还会下载该工作流 JSON,让代理有文件可以构建。桌面版不会另外下载文件,说明会指向桌面版安装目录下 `.launcher/snapshots` 中最新的快照,导入该快照时同样会把它的 JSON 发送给构建器。这段说明会列出该工作流的节点类、节点包和模型,并让代理按当前的 `comfy skills show comfy-build` 配方执行,comfy-cli 的具体命令、版本锁定、发布切版以及失败排查都由该配方负责。代理会在上传工作流之前,以及首次切版之前向你确认。之后它每次切版只修一个原因,并在每次新切版之前告诉你原因、具体改动以及这是第几次构建,最多切三次。release 不等于部署,因此说明到 green release 为止,是否部署仍是单独的决定。 +下次在该部署上运行过 Cloud 编辑器的浏览器加载 ComfyUI 时,ComfyUI 会在 Comfy Cloud 上运行,而不是已删除的部署。 -## 下一步:对其运行工作流 +## 从应用程序运行工作流 -部署上线后,请参阅[运行工作流](/zh/development/run-workflows/overview),从你的应用程序中调用它。[Comfy SDK](/zh/development/api-development/sdks) 适用于所有部署目标;自托管实例需要 [API Proxy](/zh/development/comfyui-server/api-proxy) 来提供 Comfy API v2。 +当部署为 **Ready** 时,请参阅[运行工作流](/zh/development/run-workflows/overview),从应用程序中调用它。[Comfy SDK](/zh/development/api-development/sdks) 适用于 Comfy Cloud 和你的部署。自托管的 ComfyUI 需要 [API Proxy](/zh/development/comfyui-server/api-proxy) 来提供 Comfy API v2。