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

# App Deploys

> WindsurfからNetlifyへ、パブリックURLの付与や自動ビルド、Next.js・React・Vue・Svelte向けのプロジェクト引き継ぎ機能付きでウェブアプリケーションを直接デプロイできます。

App Deploysは、Cascadeのツール呼び出しを介して、Windsurf内から直接ウェブアプリやサイトをデプロイできる機能です。パブリックURLで成果物を共有し、デプロイを更新し、プロジェクトを自分のものとして引き継いでさらなるカスタマイズを行えます。本機能は現在ベータ版で、対応フレームワークの拡充やより堅牢なビルドなどを順次提供予定です。

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

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

App Deploys を使うと、次のことができます:

* ウェブサイトや JS 製のウェブアプリをパブリックドメインにデプロイする
* 変更後に同じ URL へ再デプロイする
* プロジェクトを自分の個人アカウントに帰属させる

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

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

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

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

<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/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/app-deploys-demo1.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=844977e5cf94c8393e2418bdaec2e921" data-path="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 に依頼してください。

```
"このプロジェクトをNetlifyにデプロイする"
"デプロイメントを更新する"
```

Cascade が手順を案内し、よくある問題のトラブルシューティングをサポートします。

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

<Note> この機能を有効／無効にするには、Teams の管理者権限が必要です。</Note>

Teams および Enterprise プランをご利用のユーザーは、自分の Netlify アカウントを Windsurf アカウントと連携し、Netlify のチームにデプロイできます。

この設定は Team Settings で切り替え可能で、Profile ページから、または[こちら](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 に関する問題を防ぎ、快適な利用体験を維持できます。

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

<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/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/netlify-site-not-found.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=80793d24da70db2cfd1021616c6db559" width="2430" height="1618" data-path="assets/windsurf/cascade/netlify-site-not-found.png" />
</Frame>

ビルドが失敗している可能性が高いです。サイトを所有権申請（[deploy history](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 が古いサブドメインへ再デプロイしようとしないようにする
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が記載されているか確認します。記載がない場合は、[deploy history](https://windsurf.com/deploy) のドロップダウンから設定ファイルをダウンロードできます。
3. 再デプロイを行い、`windsurf_deployment.yaml` の `project_id` を使用するように Cascade に明示的に指示します。

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