メインコンテンツへスキップ
プロジェクト環境とは、クラウドプロジェクトがクラウドサーバー上で実行するために必要なもので、セットアップスクリプト、起動コマンド、プロジェクトが使うシークレットと環境変数から構成されます。AI はリポジトリを読み取り、セットアップスクリプトと起動コマンドを生成し、不足しているシークレットと変数を一覧にします。環境レビューであなたが確認と入力を終えると、AI はクラウドサーバー上でセットアップスクリプトを実行します。成功したら公開します。 環境構築は任意です。プロジェクトを作成したらすぐにセッションを開始できます。構築の状態はセッションの開始に影響しません。ローカルプロジェクトはコンピューター自体の環境を使うため、この手順はありません。

対応環境

入口

  • Project settings › Environment の右側にある編集ボタン(Edit environment)。
  • プロジェクトの環境変数が不足していることを知らせる通知。そのプロジェクトの環境構築ページが直接開きます。
環境構築ページはプロジェクトの独立したページです。セッションには属さず、サイドバーのセッション一覧にも表示されません。

環境ステータス

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

初回の構築

環境構築ページを初めて開くと、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 で直接変更することもできます。ワークスペース設定 を参照してください。変数を削除すると、実行中の環境には再起動後に変更が反映されます。

注意事項と制限

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

よくある質問

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

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

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

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

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

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

関連