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

# プロジェクト環境：AI による環境構築、環境レビュー、公開

> AI がクラウドサーバー上のクラウドプロジェクトに対して、セットアップスクリプト、起動コマンド、シークレット、環境変数を構築する仕組みを説明します。環境構築ページの開き方、3 ステップの環境レビュー、結果、公開、各環境ステータスの意味を扱います。

**プロジェクト環境**とは、クラウドプロジェクトがクラウドサーバー上で実行するために必要なもので、セットアップスクリプト、起動コマンド、プロジェクトが使うシークレットと環境変数から構成されます。AI はリポジトリを読み取り、セットアップスクリプトと起動コマンドを生成し、不足しているシークレットと変数を一覧にします。**環境レビュー**であなたが確認と入力を終えると、AI はクラウドサーバー上でセットアップスクリプトを実行します。成功したら公開します。

環境構築は任意です。プロジェクトを作成したらすぐにセッションを開始できます。構築の状態はセッションの開始に影響しません。ローカルプロジェクトはコンピューター自体の環境を使うため、この手順はありません。

## 対応環境

| 形態 | 対応状況 | 備考 |
| - | - | - |
| デスクトップアプリ | 対応 | |
| Web アプリ | 対応 | |
| モバイル Web | 対応 | |

## 入口

* **Project settings › Environment** の右側にある編集ボタン（**Edit environment**）。
* プロジェクトの環境変数が不足していることを知らせる通知。そのプロジェクトの環境構築ページが直接開きます。

環境構築ページはプロジェクトの独立したページです。セッションには属さず、サイドバーのセッション一覧にも表示されません。

## 環境ステータス

**Settings › Workspace › Projects** では、各クラウドプロジェクトに環境ステータスが表示されます：

| ステータス | 意味 |
| - | - |
| **Environment not set up** | 環境はまだ構築されていません。すぐにセッションを開始できます |
| **Setting up** | クラウドサーバー上でセットアップスクリプトを実行中です。その間もプロジェクトを使い続けられます |
| **Unpublished** | セットアップスクリプトは成功しましたがまだ公開されていない、または公開済みの環境に変更があります |
| **Setup failed** | セットアップスクリプトが成功しませんでした。再試行できます。セッションの開始には影響しません |
| ラベルなし | 環境がクラウドサーバーに公開されています |

## 初回の構築

環境構築ページを初めて開くと、AI はリポジトリから下書き（セットアップスクリプト、起動コマンド、必要なシークレットと変数）を生成します。**セットアップスクリプトは、あなたが環境レビューを終えてから実行されます。**

* シークレットまたは環境変数が不足している場合、入力ボックスのすぐ上に **Review environment** カードが開きます。
* 不足しているものがない場合、入力ボックスの上の **Edit environment** をクリックすると、同じカードが開いて確認できます。

AI の作業は **Worked for 12s** の下に折りたたまれています。展開するとステップが表示されます。

## 3 ステップの環境レビュー

**Review environment** カードには 3 つのステップがあります。**Next** と **Skip** で先へ進み、最後のステップで **Finish review** をクリックします。必須項目が不足している場合は **Later** をクリックしてカードを **Needs your input** という 1 行に折りたためます。クリックすると再び展開され、入力した値は保持されています。

1. **セットアップと起動を確認する**：AI が生成した **Setup script**（環境の作成時と依存関係の変更時に実行）と **Start command**（復帰のたびに実行）を確認します。編集ボタンをクリックすると変更できます。
2. **シークレットを設定する**：各シークレットの値を入力します。すでに保存されたシークレットは、空のままにすると変更されません。**Workspace** と表示された行はワークスペースレベルでの設定が推奨されているもので、ワークスペース内のプロジェクトで共有されます。その他の行は、このプロジェクトのシークレットとして保存されます。名前に使えるのは英字、数字、アンダースコアのみで、数字で始めることはできません。
3. **環境変数を設定する**：AI が値を提案した変数はあらかじめ入力されています。変更することも、**Add variable** をクリックすることもできます。保存済みの変数は値が表示されません。空のままにすると保持されます。

シークレットと環境変数のステップでは、必須の値がすべて入力されている場合にのみ **Next** を使えます。

## レビュー後

**Finish review** をクリックすると、ページに概要 **You finished the environment review**（セットアップと起動を変更したかどうか、保存したシークレット、環境変数の数）が表示され、その後 AI は確認済みのスクリプトでクラウドサーバー上のセットアップスクリプトを実行します。シークレットの値はページには表示されません。

## 構築の結果

### 環境の準備完了

セットアップスクリプトが成功すると、**my-app is ready** を含む環境カードが表示され、リポジトリ、ランタイム、セットアップスクリプト、起動コマンド、シークレット（値がないものには **(missing)** と表示されます）、環境変数の数が一覧になります。

* **Edit**：レビューカードを再度開き、変更して再実行できます。
* **Publish to cloud server**：公開後、カードは **my-app is published** に変わります。**Start a task** をクリックすると、このプロジェクトが選択された状態で新しいセッションのページが開きます。

### 構築の失敗

セットアップスクリプトが成功しなかった場合、エラーメッセージが表示されます。セッションの開始には影響しません：

* **Retry**：最新のスクリプトを再度実行します。
* **Edit environment**：スクリプトを変更し、**Finish review** をクリックして再実行します。

## リクエストを追加する

構築の失敗後、準備完了後、公開後に、ページ下部の入力ボックス（**Ask for follow-up changes**）からリクエストを送信でき、AI がそれに応じて環境を再度構築します。構築中は送信できません。ここではモデルを変更できません。

## 公開済みの環境を変更する

**Project settings › Environment** から環境構築ページを開き、**Edit environment** をクリックし、変更後に **Finish review** をクリックしてセットアップスクリプトを再実行します。成功すると、プロジェクトは **Unpublished** になります。変更を反映するには、再度 **Publish to cloud server** をクリックしてください。

プロジェクトレベルのシークレットと変数は、**Settings › Workspace › Secrets & variables** で直接変更することもできます。[ワークスペース設定](https://docs.aihubmix.com/jp/cloud/settings/workspace.md) を参照してください。変数を削除すると、実行中の環境には再起動後に変更が反映されます。

## 注意事項と制限

* シークレットをセッションや環境構築ページの入力ボックスに直接送信しないでください。環境レビューまたは **Settings › Workspace › Secrets & variables** で入力してください。
* クラウド環境がアクセスできるのはパブリックインターネットのみです。
* 環境構築は、クラウドサーバー上のクラウドプロジェクトにのみ適用されます。

## よくある質問

### 環境レビューをスキップしました。後からシークレットを追加できますか？

追加できます。**Settings › Workspace › Secrets & variables** で追加するか、環境構築ページに戻って **Edit environment** をクリックしてください。

### 公開前にセットアップスクリプトを変更できますか？

変更できます。環境カードの **Edit** をクリックするか、レビューのステップ 1 で直接編集してください。

### プロジェクトを作成した後、構築が自動で始まらなかったのはなぜですか？

環境構築は任意です。構築が必要な場合は、**Project settings › Environment** に移動して編集ボタンをクリックしてください。

## 関連

* [プロジェクト](https://docs.aihubmix.com/jp/cloud/projects/projects.md)
* [ワークスペース設定](https://docs.aihubmix.com/jp/cloud/settings/workspace.md)
* [実行環境：あなたのデバイス上とクラウドサーバー](https://docs.aihubmix.com/jp/cloud/projects/run-environment.md)
* [クラウドサーバー](https://docs.aihubmix.com/jp/cloud/cloud-host/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.