> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# App Deploys

> Devin Desktop から Netlify に Web アプリやサイトを直接デプロイできます。公開 URL、自動ビルド、プロジェクトの引き継ぎに対応し、Next.js、React、Vue、Svelte で利用できます。

App Deploys を使うと、Cascade のツール呼び出しを通じて、Devin Desktop 内から Web アプリケーションやサイトを直接デプロイできます。この機能により、公開 URL で成果物を共有したり、デプロイを更新したり、さらにカスタマイズするためにプロジェクトを引き取ったりできます。現在はベータ版で、今後は追加のフレームワーク対応や、より堅牢なビルド機能などを順次提供予定です。

<Frame>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/app-deploys-ui.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=874c98c462094169ac798cecca2a6221" width="2072" height="576" data-path="desktop/assets/windsurf/cascade/app-deploys-ui.png" />
</Frame>

<div id="overview">
  ## 概要
</div>

App Deploys を使用すると、次のことができます。

* Web サイトまたは JS Web アプリを公開ドメインにデプロイする
* 変更後に同じ URL へ再デプロイする
* プロジェクトを個人アカウントに引き取る

<Warning>
  App Deploys は主にプレビュー用途を想定しています。機密データを扱う本番
  アプリケーションでは、デプロイを自分のアカウントに引き取ったうえで、
  セキュリティのベストプラクティスに従うことを推奨します。
</Warning>

<div id="supported-providers">
  ## 対応プロバイダー
</div>

現在、以下のデプロイプロバイダーに対応しています。

* **Netlify** - 静的サイトおよびWebアプリケーション向け

<Note>追加のプロバイダーへの対応は、今後のリリースで予定されています。</Note>

<div id="how-it-works">
  ## 仕組み
</div>

App Deploysを利用すると、コードは当社のサーバーにアップロードされ、当社の管理下にあるアカウントを通じてプロバイダーにデプロイされます。デプロイされたサイトは、次の形式の公開URLで利用できるようになります。

```
<SUBDOMAIN_NAME>.windsurf.build
```

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/app-deploys-demo1.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=e2e734de5e247eb6d310f90e657da37f" data-path="desktop/assets/windsurf/cascade/app-deploys-demo1.mp4" />

<div id="deployment-process">
  ### デプロイの流れ
</div>

1. Cascade がプロジェクトを解析し、適切なフレームワークを特定します
2. プロジェクトファイルは安全に当社のサーバーにアップロードされます
3. プロバイダーのプラットフォーム上にデプロイが作成されます
4. 公開 URL とデプロイを引き取るためのリンクが提供されます

<div id="project-configuration">
  ### プロジェクト設定
</div>

再デプロイしやすくするため、プロジェクトのルートに `windsurf_deployment.yaml` ファイルを作成します。このファイルには、プロジェクト ID やフレームワークなど、今後のデプロイに必要な情報が含まれます。

<div id="using-app-deploys">
  ## App Deploys の使い方
</div>

アプリケーションをデプロイするには、Cascade に次のように依頼するだけです。

```
"Deploy this project to Netlify"
"Update my deployment"
```

Cascade が手順に沿ってガイドし、よくある問題のトラブルシューティングをサポートします。

<div id="team-deploys">
  ## チームへのデプロイ
</div>

<Note>この機能の切り替えには、Team 管理者権限が必要です。</Note>

Teams プランおよび Enterprise プランをご利用のユーザーは、Netlify アカウントを Devin Desktop アカウントに接続して、Netlify Team にデプロイできます。

この設定はチーム設定で切り替えられます。チーム設定には、プロフィールページまたは[こちら](https://windsurf.com/team/settings)からアクセスできます。

<div id="security-considerations">
  ## セキュリティに関する注意事項
</div>

<Warning>
  デプロイのため、お客様のコードは当社のサーバーにアップロードされます。公開しても差し支えないコードのみを
  デプロイしてください。
</Warning>

当社では、セキュリティを確保するために次のような対策を講じています。

* ファイルサイズの制限と検証
* お客様のアカウントのティアに応じたレート制限
* プロジェクトファイルの安全な取り扱い

プライバシーをさらに高めるには、[clear-cookies.windsurf.build](https://clear-cookies.windsurf.build) にアクセスし、`windsurf.build` 配下のサイトによって設定された Cookie がないか確認し、見つかった場合は削除してください。Cookie が表示される場合、本来そこにあるべきものではありません。削除することで、クロスサイト Cookie の問題を防ぎ、利用環境をクリーンに保つことができます。

Devin Desktop のサイトは人間と AI によって構築されています。AI にはベストプラクティスに沿った判断を促していますが、念のため引き続き注意して利用することをおすすめします。Devin Desktop は、ユーザーがデプロイしたサイトに起因する問題について責任を負いません。

<div id="claiming-your-deployment">
  ## デプロイを引き取る
</div>

デプロイ後、引き取り用の URL が発行されます。このリンクから、個人のプロバイダーアカウントでプロジェクトを引き取ることができ、次のことが可能になります。

* デプロイを完全に管理できる
* プロバイダー固有の機能を利用できる
* ドメイン名を変更できる
* ログやビルド情報に直接アクセスできる

<Note>
  引き取られていないデプロイは、一定期間後に削除される場合があります。重要なプロジェクトは早めに引き取ることを推奨します。
</Note>

<div id="rate-limits">
  ## レート制限
</div>

不正利用を防ぐため、以下のティア別レート制限を適用しています。

| プラン  | 1日あたりのデプロイ上限 | 未請求サイトの上限 |
| ---- | ------------ | --------- |
| Free | 1            | 1         |
| Pro  | 10           | 5         |

<div id="supported-frameworks">
  ## 対応フレームワーク
</div>

App Deploys は、以下を含む主要な JavaScript フレームワークのほとんどに対応しています。

* Next.js
* React
* Vue
* Svelte
* 静的な HTML/CSS/JS サイト

<div id="troubleshooting">
  ## トラブルシューティング
</div>

<div id="failed-deployment-build">
  ### デプロイ時のビルド失敗
</div>

デプロイが失敗する場合:

1. Cascade が提供するビルドログを確認します
2. プロジェクトをローカルでビルドできることを確認します (テストには `npm run build` を実行します)
3. プロジェクトがフレームワークの推奨構成に従っていることを確認します
4. [`netlify.toml` を使用してフレームワークを Netlify にデプロイする方法](https://docs.netlify.com/configure-builds/file-based-configuration/)についてドキュメントを参照します
5. プロバイダーのダッシュボードで詳細なログにアクセスするために、プロジェクトを引き取ることを検討します

<Warning>
  フレームワーク固有のビルドエラーについては、直接サポートできません。コードの問題が原因で
  デプロイが失敗する場合は、ローカルでデバッグするか、プロジェクトを引き取って
  プロバイダーのサポートチームと連携してください。
</Warning>

<div id="netlify-site-not-found">
  ### Netlify サイトが見つかりません
</div>

<Frame>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/netlify-site-not-found.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=3d3f9ec85716d984c8da2d3847b28afa" width="2430" height="1618" data-path="desktop/assets/windsurf/cascade/netlify-site-not-found.png" />
</Frame>

これは、ビルドが失敗した可能性が高いことを意味します。サイトを引き取り ([デプロイ履歴](https://windsurf.com/deploy) で確認できます) 、詳細はビルドログを確認してください。多くの場合、ビルドログを Cascade に貼り付けて、サポートを求めることができます。

<div id="changing-your-subdomain-url">
  ### サブドメイン / URL の変更
</div>

<div id="updating-netlifyapp-domain">
  #### `netlify.app` ドメインの更新
</div>

デプロイを引き取り、Netlify サイトの設定を更新すると、サブドメインを変更できます。これにより、`.netlify.app` ドメインも更新されます。

<div id="updating-custom-windsurfbuild-subdomain">
  #### カスタム `.windsurf.build` サブドメインの更新
</div>

<Warning>
  デプロイ後は、カスタム `.windsurf.build` サブドメインを変更できません。代わりに、新しいサブドメインで新しいサイトをデプロイする必要があります。
</Warning>

カスタム `.windsurf.build` サブドメインを更新するには、新しいサブドメインで新しいサイトをデプロイする必要があります。

1. プロジェクトから `windsurf_config.yaml` ファイルを削除します
2. Cascade に、新しいサブドメインで新しいサイトをデプロイするよう依頼し、希望するサブドメインを伝えます
3. Cascade が古いサブドメインに再デプロイしないよう、新しい会話を開始するか、自動生成された Memories をクリアするとよい場合があります
4. 新しいデプロイメントを作成すると、「Deploy」を押す前に、UI 上のサブドメインの「Edit」ボタンを押して更新できます

<div id="error-unable-to-get-project-name-for-project-id">
  ### エラー: `Unable to get project name for project ID`
</div>

このエラーは、プロジェクト ID が当社の管理システムで見つからない場合、または Cascade がサブドメインを誤ってプロジェクト ID として利用している場合に発生します。対処法:

1. プロジェクトが Netlify アカウント内にまだ存在していることを確認してください (クレーム済みであることが前提です) 。
2. `windsurf_deployment.yaml` ファイルにプロジェクト ID が含まれていることを確認してください。ファイルに含まれていない場合は、[デプロイ履歴](https://windsurf.com/deploy) のドロップダウンから設定ファイルをダウンロードできます。
3. 再デプロイを試し、Cascade に `windsurf_deployment.yaml` ファイル内の `project_id` を利用するよう、より明示的に指示してください

<Frame>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/app-deploys-download-config-file.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=fbbc9d8789e65ff8926bd8dad20e828d" width="1966" height="1408" data-path="desktop/assets/windsurf/cascade/app-deploys-download-config-file.png" />
</Frame>