Cloud環境を作成する

ワークスペースのCloud Projectは1つのCloud環境を共有します。PCを閉じていてもCognoが作業を続けられます。準備とアカウントへの接続状況は設定 → Cloudで確認できます。 Cloud Projectはこの共有環境を使用します。Localフォルダー接続の案内はLocal Projectにのみ表示されます。設定 → マシン一覧のコンピューター一覧はLocalとリモートのコンピューターを表示します。共有Cloud環境は設定 → Cloudにあります。

​

前提条件

ワークスペースでCloud環境の作成が利用可能である必要があります。作成と作成の再試行には、ワークスペースを更新する権限が必要です。 新しいCloud環境の作成にはBusinessプランが必要です。Freeプランでは、請求を管理できる場合はCloud環境のステップにBusinessにアップグレードが表示され、それ以外の場合はBusinessプランが必要であることが表示されます。作成済みの環境は、後でFreeプランに戻っても引き続き使えます。

​

Cloudをバックグラウンドで準備する

CloudflareのCloud実行を有効にした環境では、Businessの契約確定後にCloudの準備が自動的に始まります。いつもどおり作業を続けたり画面を閉じたりしても、準備はバックグラウンドで進みます。明示的に停止・削除した環境は、請求情報の更新によって再起動しません。 設定 → CloudのすべてのProjectで状況を確認できます。Local Projectの実行先はPCのままです。あなたのアカウントには自分のCodexとClaudeの接続が表示されます。Cloudで使いたいアカウントの横にある接続するを選択してください。Local Projectを含む任意のProject設定からも同じ接続を登録できます。

​

環境を手動で作成する

環境を削除した後など、自動setupを使わない場合は手動で作成できます。自動setupを待っているBusinessワークスペースでは、個別の作成ステップの代わりに準備状況が表示されます。 設定 → Cloudでは、Cloud環境とCloud上のProjectの2つのステップがつながって表示されます。チェックが付いたステップは完了で、次のステップに押すべきボタンが1つ表示されます。Cloud環境がない状態でProject作成メニューのCloudで作成を選んだ場合も、このページに移動します。 ステップの下には、Workspaceの構成図が表示されます。メンバーのPCとCloudのそれぞれに、そこで動くProjectとそのrepositoryが並びます。Cloud環境の準備ができるまで、Cloudは点線の枠で表示されます。 作成に失敗した場合は、最初のステップに理由と再試行が表示されます。実行インフラの問題では、再試行の前にWorkspace管理者へ確認を依頼してください。環境を作成すると、ステップの下にCloud環境を削除が表示されます。

​

Cloud アカウントに接続する

Cloud Projectの作成には、利用中の環境でCloud実行が有効になっている必要があります。 リポジトリを選択すると、Projectの要件として保存されます。作業用コピーの準備はTaskの開始時に行います。Project作成やアカウントへのログインではリポジトリをcloneしません。 書き込み権限とアカウント接続権限を持つメンバーは、自分のアカウントに接続できます。Project Ownerである必要はありません。設定 → CloudまたはProject設定のあなたのアカウントで、ClaudeまたはCodexの横にある接続するを選択します。どちらも同じ個人接続を保存します。Claudeは別タブでログインし、表示されたコードをCognoの認証コードに貼り付け、接続を完了を選択します。 OwnerとしてCloud Projectを開くと、選択中のClaudeまたはCodexの接続状態を確認します。Cloud環境が停止している場合は、Projectを開くと起動し、準備が完了するまで待ちます。保存されたログインがない、または無効な場合はアカウントを再接続を表示します。選択すると既存の接続画面を開きます。Projectを開くだけではログイン開始や保存済み認証情報の変更は行いません。接続状態を確認できない場合は再試行を選択してください。プロバイダーやネットワークの障害を認証切れとして扱うことはありません。

​

Cloud Taskを開始する

Cloud Projectを開いてTaskを作成し、フルフォームの進め方パネルで担当者を選びます。 実装を見るで実行を開始し、Plan するで計画だけのrunを開始します。 自分へのアサインでも、別のメンバーへのアサインでも、ProjectのCloud環境を使います。接続済みのメンバーから、Task担当者、前回のCloud実行者、直近7日のCloud実行が最も少ないメンバーの順に実行者を選びます。選ばれたメンバーと提供元は実行中に変わりません。誰も接続していない場合は待機します。ブラウザから開始でき、Desktopを開いたりLocal Environmentを選んだりする必要はありません。 Projectの実行先を確認してから、この2つの開始操作が有効になります。確認に失敗した場合は 再試行を選びます。あとではBacklogに保存し、作成は実行を開始せずに保存します。 コーディングエージェントが開始する前に、Projectのリポジトリの作業用コピーを準備します。準備には最大5分かかる場合があります。準備が失敗すると、その実行は失敗として終了します。 ワークスペースのCloud環境では、Cloud Project全体で最大3件のエージェント実行を同時に進められます。Cloud TaskとProjectの作業でこの上限を共有します。上限を超えたリクエストは、空きができるまで自動的に再試行されます。

​

CloudでProjectの作業を実行する

Cloud Projectの作業は、ワークスペースのCloud環境で実行します。1つのメンションで複数のProjectが選ばれ、その中にCloud Projectがある場合は、1つのエージェント実行としてCloud環境で処理します。 選ばれたProjectのコンテキストは利用できますが、メンバーのLocal Machineにあるフォルダにはアクセスできません。すべてLocal Projectの場合は、既存のLocal Machine選択を使います。Cloud環境がない場合にLocal Machineへ切り替わることはありません。 新しいCloud TaskとProjectの作業は、Cloudの実行用OSアカウントの権限内で、コマンド実行とファイル操作にfull accessを使います。 計画だけのrunは引き続き読み取り専用です。連携Toolの許可設定も引き続き適用されます。

​

Cloud Taskで使えるTool

Cloud TaskはWorkspaceのTool許可設定に従い、CognoのToolと選ばれた実行者が利用できる 連携接続を使います。他のTask実行と同じく、ProjectのTool許可の上書きで絞り込まれます。 個人接続は引き続き所有者だけが使え、既存のProjectのリソースフィルターも適用されます。 常に許可されたToolは実行できます。拒否または承認が必要なToolは、承認フローのない 自律Cloud Taskでは実行できません。許可を取り消すと、実行中のTaskからの以後の呼び出しも 拒否されます。その実行の完了・取消、またはCloud環境の中断でアクセスは失効します。

​

自動停止と再起動

Cloud環境は15分ごとに活動の有無を確認します。受け付け済みの作業、アカウントへの接続処理、 結果の保存がすべて完了し、最後の活動から15分以上経過した後に停止します。 通常は最後の活動から約15〜30分と処理遅延を経て停止します。 停止中に届いた新しい作業は、環境の再起動を待ちます。停止してもProjectのファイルと 接続済みアカウントは保持されます。次のCloud TaskまたはProjectの作業で環境を再起動します。

​

共有Cloud環境を削除する

WorkspaceとProjectを残して共有VMを削除するには、設定 → Cloud → Cloud環境を削除を開きます。 影響を確認して共有VMとディスクを削除を選択します。Workspaceの更新権限が必要です。 Project Ownerであることだけでは削除できません。 削除はバックグラウンドで進み、一時的な障害は再試行されます。画面を離れたり再読み込みした後も、 Cloud設定に戻って状況を確認できます。不在確認が完了すると作成が利用できます。 環境を再作成してから、各Cloud ProjectのCloud アカウント設定で再接続してください。 以前のファイルとログイン情報は復元されません。永続ストレージはインフラproviderの削除方針で回収されます。 状況表示はディスクの物理消去を証明するものではありません。

​

ワークスペースのCloud環境を削除する

ワークスペースのOwnerがグループワークスペースを削除すると、CognoはそのCloud環境も削除します。ワークスペースへのアクセスは直ちに終了します。環境の削除はワークスペース削除後にバックグラウンドで進むため、時間がかかる場合があります。一時的なサービス障害は自動的に再試行されます。

​

トラブルシューティング

​

ログインが完了しない

起動に時間がかかる場合やログインの有効期限が切れた場合は、接続画面の再試行を選択します。Projectは保存されたままです。後からProjectのCloud アカウント設定へ戻ることもできます。提供元での認証確認の失敗はエラーとして表示され、接続成功にはなりません。 有効期限切れが確認されたログインでは、新しいCloud Taskを開始する前に再接続が必要です。Projectを開いてアカウントを再接続を選択するか、Project設定のCloud アカウントを使用してください。再接続しても、失敗したTaskは自動で再試行されません。 Cloud環境自体の起動に失敗した場合、設定 → Cloudの最初のステップに起動できませんでしたと表示されます。接続画面を開いても再起動を繰り返しません。ワークスペースのOwnerまたは管理者は、そのステップまたは接続画面の再試行で、受け付け済みの作業が確定してから新たな起動を要求できます。起動が終わるまで、ステップには起動中と表示されます。Project Ownerであることだけでは復旧権限は付与されず、失敗したTaskも自動では再実行されません。 Cloudで実行を待っている作業があるときは、Cognoがこの復旧を自動で要求します。起動の失敗が続く場合は、試す間隔を5分から最大1時間まで広げます。待っている作業がないときは、誰かが再試行を選ぶまで、失敗した状態のまま残ります。 Cloudの空きが一時的に足りない場合、設定 → CloudにCloudの空きを待っていますと表示されます。これは失敗ではありません。空きができしだい環境は自動で起動し、待っている作業もそのときに届きます。再試行の操作は不要です。

​

Cloud の作業がログインを待っている

Cloud の作業は、Codex か Claude のアカウントを接続したワークスペースのメンバーとして動きます。 誰も接続していないワークスペースでは、Cloud の作業は始まらずに待ちます。オーナーと管理者には、 Inbox に Cloud の作業がログインを待っています という通知が1日に1回まで届き、選ぶと 設定 → Cloud が開きます。 そこでメンバーがアカウントを接続すると、待っていた作業は自動で始まります。依頼し直す必要はありません。 24時間たっても待っている作業は、この理由で失敗になります。アカウントを接続してから、もう一度依頼してください。

​

作成状況を読み込めない

作成状況を取得できない場合の再試行は、状況を取得し直します。作成失敗時の再試行は、作成を再リクエストします。閲覧のみのメンバーは状況を確認できますが、作成や作成の再試行はできません。 既知の作成失敗理由は、インターフェースの言語で表示されます。理由が取得できない場合や未対応の理由の場合は、汎用の作成失敗メッセージが表示されます。

​

関連ドキュメント

• Projects
• 実行アクセス