ワークスペースの操作状態

ワークスペースの状態の概要

ワークスペースの状態を以下の表にまとめます。 IBM Cloud コンソールでは、一部の状態が表示されないことがあります。状態の中には、コマンド・ラインまたは API の使用時のみ表示されるものもあります。

ワークスペースの状態の概要
状態	説明
`Active`	Terraform 実行プランを適用して IBM Cloud Schematics でインフラストラクチャー・コードを正常に実行すると、ワークスペースの状況は「アクティブ (Active)」に変わります。
`Connecting`	Schematics はソース・リポジトリーのテンプレートへの接続を試行しています。正常に接続すると、テンプレートがダウンロードされ、入力パラメーターなどのメタデータが抽出されます。テンプレートのダウンロードが完了すると、ワークスペースの状態は「スキャン中 (Scanning)」に変化します。
`Draft`	`GitHub` リポジトリー、`GitLab` リポジトリー、または `Bitbucket` リポジトリーへの参照なしでワークスペースが作成されています。
`Failed`	IBM Cloud Schematics でのインフラストラクチャー・コードの実行中にエラーが発生した場合、ワークスペースの状態は「失敗 (Failed)」に設定されます。エラーをトラブルシューティングするには、ワークスペースの「アクティビティー」ページでログを開きます。
`Inactive`	Schematics テンプレートのスキャンが正常に完了し、ワークスペースの作成が完了しました。 Schematics プランを開始し、テンプレートで指定したクラウドリソースをプロビジョニングするジョブを適用できます。「アクティブ (Active)」なワークスペースがある場合に、すべてのリソースを削除すると、すべてのリソースが削除された後にそのワークスペースは「非アクティブ (Inactive)」に設定されます。
`Inprogress`	Terraform 実行プランを適用してインフラストラクチャー・コードを実行するように IBM Cloud Schematics に指示すると、ワークスペースの状態が `Inprogress` に変わります。
`Scanning`	Schematics テンプレートのダウンロードが完了し、脆弱性スキャンが開始されました。スキャンが正常に完了すると、ワークスペースの状態は「非アクティブ (Inactive)」に変わります。テンプレートでエラーが検出されると、状態は「テンプレート・エラー (Template Error)」に変わります。
`Stopped`	plan、apply、destroy のいずれかの Schematics ジョブが手動で停止されました。
`Template_Error`	Schematics テンプレートにエラーがあるため、このテンプレートを処理できません。

ワークスペースの状態遷移図と操作ジョブ

ワークスペースの状態は、Terraform 実行プランが正常に作成されたかどうか、および、それが適用されて IBM Cloud アカウントへのリソースのプロビジョンが正常に行われたかどうかを示します。以下の表に、状態とワークスペースのジョブを示します。

ワークスペースの状態遷移図
ワークスペース	状態ダイアグラム	説明
`Create workspace`		ワークスペースは、ドラフト状態への `GitHub`、`GitLab`、または `Bitbucket` の参照なしで作成されます。ドラフト状態から、ソース・リポジトリー内のインフラストラクチャー・テンプレートに接続することができます。接続状態から、テンプレートは正常に処理されて非アクティブ状態 (最終状態) に達します。テンプレート解析が失敗して失敗状態に達する場合もあります。非アクティブ状態からは、適用を実行した結果 1 つのリソースになると、状態はアクティブ状態になり、それらが破棄されると状態は破棄状態になります。ワークスペースをアクティブ状態にするために、状態ファイル内の少なくとも 1 つのリソースを、ジョブの適用によって維持することができます。 Schematics は、その後のTerraformコマンドを実行するためのユーザー定義ファイルを保存します。その後、すべてのリソースを破棄して、ワークスペースを非アクティブ状態にすることができます。
`Delete workspace`		非アクティブ状態、アクティブ状態、または失敗状態でワークスペースの削除を実行する場合。これらの状態から、テンプレートが正常に解析されて非アクティブ状態に達します。テンプレート解析が失敗して失敗状態に達することもあります。少なくとも 1 つのリソースを削除すると、計画および適用ジョブが実行され、アクティブ状態のリソースが破棄されます。
`Plan and apply job`		アクティブ状態、非アクティブ状態、および失敗状態で計画または適用ジョブを実行する場合。ワークスペースは進行中であり、ロック状態になっています。ここでジョブが実行され、成功した場合はワークスペースがアクティブ状態になり、少なくとも 1 つのリソースが含まれている場合はワークスペースが非アクティブ状態になり、失敗するとワークスペースは失敗状態になります。 Schematics は、その後のTerraformコマンドを実行するためのユーザー定義ファイルを保存します
`Destroy job`		破棄ジョブは、ワークスペースが非アクティブ状態、アクティブ状態、または失敗状態のときに実行されます。これらの状態から、破棄ジョブはソース・リポジトリーにあるテンプレートを解析するために接続され、ワークスペースは進行中かつアンロック状態になります。破棄すると、リソースは失敗状態になります。

IBM Cloud Schematics への自動デプロイメントの作成

IBM Cloud Schematics は、新しい Git リポジトリー内のコードの複製コピーで Git リポジトリーを共有するための効率的な方法をサポートするようになりました。これにより、元のコードに影響を与えることなく、IBM Cloud にデプロイできます。 IBM Cloud への展開の詳細については、 Schematics への展開の自動化を参照してください。

Schematics のジョブの詳細の確認

コンソールの Schematics ジョブ・ページを使用して、すべての Schematics アクティビティー (template、plan、apply のダウンロードなど) の履歴を検索し、ジョブのログを表示します。テンプレートを実行するとジョブが作成されます。 plan または apply ジョブ内にあって、状態が added、modified、または destroyed であるリソースのカウントも表示されます。ジョブキュー処理の詳細については、「 Schematics ジョブキューの実行プロセス」を参照してください。

ジョブ・ログには、以下のようなメッセージが表示されます。

アクティビティーがトリガーされました。ログを待機しています。これは、ジョブが保留状況で、まだ処理されていないことを示します。
ジョブが実行依頼され、y の x 位置でキューに入っています。ここで、x は保留キュー内のジョブの位置で、y は保留ジョブの合計です。 Schematics バックエンドで使用可能なリソースは、保留中のジョブに均等に配布されます。大量のジョブを実行している場合は、合計とともに位置の増加を表示できます。