リソース・マネージャの概要

次に、リソース・マネージャの主な概念およびコンポーネントの簡単な説明を示します。

構成

インフラストラクチャを調整するための情報。指定のスタック内のOracle Cloud Infrastructureリソースを指定するには、構成を使用します。たとえば、リソース・メタデータ、データ・ソース定義および変数宣言を指定します。各Terraform構成ファイルは、HashiCorp構成言語(HCL)形式またはJSON形式です。HCL形式のファイルは、ファイル拡張子.tf を使用します。JSON形式のファイルは、ファイル拡張子.tf.jsonを使用します。

リソース・マネージャでサポートされているTerraform構成ソースについては、「Terraform構成の格納場所」を参照してください。

構成の例は、Terraformプロバイダの例およびOracle提供のテンプレートを参照してください。詳細は、リソース・マネージャのTerraform構成および構成のオーサリングを参照してください。HashiCorp: 構成も参照してください。

構成ソース・プロバイダ

Terraform構成ファイルが格納されているソース・コード制御システムへの接続情報。構成ソース・プロバイダを使用して、バージョン管理されたリモートのTerraform構成ファイルからスタックを作成します。

構成ソース・プロバイダには、次のタイプがあります: 

• ビットバケット: サポートされている製品

  • Bitbucketクラウド
  • Bitbucketサーバー
• GitHub:サポート対象製品

  • GitHub Enterprise
  • • GitHub Enterprise Server
    • GitHub Enterprise Cloud
  • GitHub無料(組織)
  • ユーザー・アカウント用のGitHub Free
  • GitHubチーム
• GitLab:サポートされている製品

  • GitLab Community Edition
  • GitLab Enterprise Edition
  • GitLab.com

構成ソース・プロバイダには、次のライフサイクル状態があります:

• アクティブ: 構成ソース・プロバイダは使用可能です。

詳細は、構成ソース・プロバイダの管理およびスタックの作成を参照してください。

CI/CDパイプラインでのクラウド・プロビジョニングにCLIを使用する手順は、「クラウドでのIaCの使用: CI/CDパイプラインへのTerraformおよびリソース・マネージャの統合- OCI CLIを使用した構築」を参照してください。

ドリフト

インフラストラクチャの現実世界での実際の状態とスタックの最終実行構成との差異。たとえば、チーム・メンバーがリソースに本番タグを追加したとき、またはリソースに障害が発生したときにドリフトが発生します。ドリフト検出レポートを実行して、プロビジョニングされたリソースの状態が、スタックの最終実行構成で定義されているリソースとは異なるかどうかを確認できます。各リソースの詳細なドリフト・ステータスを表示することもできます。

ジョブ

構成に定義されているアクションを実行する手順。特定のスタック上で実行できるジョブは、一度に1つのみです。さらに、Oracle Cloud Infrastructureリソースのセットは、特定のスタック上に1セットのみ持つことができます。別のリソース・セットをプロビジョニングするには、個別のスタックを作成し、別の構成を使用する必要があります。

ジョブには、関連付けられたスタックに関する履歴が格納されます。たとえば、計画ジョブは、生成された実行計画を格納し、ジョブ・ストア構成(スナップショット)および状態ファイルを適用します。ジョブは、関連付けられているスタックと同じコンパートメントに存在します。OCIDが各ジョブに割り当てられます。

リソース・マネージャ・ジョブ・タイプの詳細は、ジョブの作成を参照してください。

ジョブには、次のライフサイクル状態があります:

• 承認済 (ACCEPTED): ジョブは処理のために受け入れられました。
• 進行中 (IN_PROGRESS): ジョブは実行中(実行中)です。
• 失敗 (FAILED): ジョブの実行が完了しませんでした。
• 成功 (SUCCEEDED): ジョブは正常に完了しました。
• 取消中 (CANCELING): ジョブは取り消されています。通知は送信されましたが、ジョブの実行はまだ停止されていません。
• 取消済 (CANCELED): ジョブは取り消され、実行が停止されました。

デフォルトの再試行ポリシー: ダウンストリーム・サービスの問題により、ジョブが失敗することがあります。たとえば、コンピュート・インスタンスを作成するための適用ジョブは、コンピュート・サービスの一時的な接続の問題のために失敗することがあります。ダウンストリーム・サービスの問題のためにジョブが失敗した場合、Go SDKのデフォルト再試行ポリシーに従ってジョブが再試行されます。Go SDK for Oracle Cloud Infrastructureを参照してください。

モジュール

関連するリソースのグループ。モジュールを使用して軽量および再利用可能な抽象を作成し、アーキテクチャという観点からインフラストラクチャを記述できます。詳細は、モジュールの作成を参照してください。

package

通常は、GitHubなど、サポートされているプロバイダに格納されているTerraform構成への.zipファイルです。詳細は、「Oracle Cloudにデプロイ」ボタンの使用」を参照してください。

プライベート・エンドポイント

非公開リソースに接続するためのネットワーク情報。詳細は、プライベート・エンドポイントの管理を参照してください。

リソース検出

デプロイされたOracle Cloud InfrastructureリソースをTerraformの構成および状態ファイルとして取得する機能。詳細は、リソース検出を参照してください。

スタック

特定のTerraform構成に対応するOracle Cloud Infrastructureリソースのコレクション。各スタックは、指定したコンパートメントの単一のリージョンに存在しますが、指定したスタック上のリソースは複数のリージョンにデプロイできます。OCIDが各スタックに割り当てられます。

スタックを作成するステップは、スタックの作成を参照してください。リソース・マネージャでサポートされているTerraform構成ソースについては、Terraform構成の格納場所を参照してください。

スタックには、次のライフサイクル状態があります:

• 作成中: スタックを作成中です。
• アクティブ: スタックは使用可能です。
• 削除中: スタックは削除中です。
• 削除済: スタックは削除されました。
• 失敗: スタックを作成できませんでした。

状態

リソース構成の状態で、状態ファイル(.tfstate)の JSON形式で格納されます。詳細は、State Managementを参照してください。

template

組込みのTerraform構成。一般的なシナリオで使用される一連のリソースをプロビジョニングします。テンプレートは、Oracleまたはテナンシ内の誰かがプライベート・テンプレートとして指定できます。テンプレートからスタックを作成するには、テンプレートからのスタックの作成を参照してください。詳細は、Oracle提供のテンプレートを参照してください。

プライベート・テンプレートを作成するには、プライベート・テンプレートの管理を参照してください。

リソース・マネージャ・サービスは、すべてのOracle Cloud Infrastructure商用リージョンで使用できます。使用可能なリージョンのリストと、関連する場所、リージョン識別子、リージョン・キーおよび可用性ドメインは、リージョンおよび可用性ドメインについてを参照してください。

次のイメージは、リソース・マネージャ・ワークフローの一般的なビューを表しています。

1. Terraform構成を作成します。

   ノート リソース・マネージャでサポートされているTerraform構成ソース
   
   については、「Terraform構成の格納場所」を参照してください。
2. スタックを作成します。
3. 実行計画を生成する計画ジョブを実行します。
4. 実行計画(ジョブ・ログ)を確認します。
5. 実行計画で変更が必要な場合は、構成を更新して計画ジョブを再度実行します。
6. リソースをプロビジョニングするために適用ジョブを実行します。
7. 必要に応じて状態ファイルおよびログ・ファイルを確認します。
8. 適用ジョブを再実行することによって、構成を変更の有無にかかわらずオプションで再適用できます。
9. オプションで、スタック上で実行されているリソースを解放するには、破棄ジョブを実行します。

リソース・マネージャ・ワークフローの詳細なウォークスルーは、スタート・ガイドを参照してください。

リソース・マネージャ・サービスには、コンソール(ブラウザベースのインタフェース)またはリソース・マネージャREST APIを使用してアクセスできます。コンソールおよびAPIのための手順は、このガイド全体を通してトピックに含まれています。使用可能なSDKのリストは、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。

コンソール: リソース・マネージャにコンソールを使用してアクセスするには、サポートされているブラウザを使用する必要があります。コンソールのサインイン・ページに移動するには、このページの上部にあるナビゲーション・メニューを開き、「Infrastructureコンソール」をクリックします。クラウド・テナント、ユーザー名およびパスワードの入力を求められます。ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「リソース・マネージャ」で、「概要」をクリックします。

API: APIを介してリソース・マネージャにアクセスするには、リソース・マネージャAPIを使用します。

CLI: リソース・マネージャのコマンドライン・リファレンスを参照してください。

デフォルトでは、リソース・マネージャはOracle Cloud InfrastructureのTerraformプロバイダであるterraform-provider-ociをサポートしています。

サポートされているサードパーティTerraformプロバイダは、サポートされているTerraformプロバイダを参照してください。

管理者:グループにリソース・マネージャ・リソースへのアクセス権を付与する共通ポリシーについては、IAMポリシー(リソース・マネージャの保護)を参照してください。

IAMポリシーの作成に加えて、リソース・マネージャのセキュリティのベスト・プラクティスに従います。

• 構成ファイルと出力ファイルで機密情報の使用を制限します
• セキュリティ監査の実行
• プライベート・エンドポイントを使用して、ネットワーク・トラフィックをパブリックに公開せずにリソースにセキュアにアクセス

セキュア・リソース・マネージャを参照してください。

リソース・マネージャの制限を参照してください。

適用可能な制限の一覧と制限拡大をリクエストする手順は、「サービス制限」を参照してください。リソースまたはリソース・ファミリにコンパートメント固有の制限を設定するために、管理者は、コンパートメント割当てを使用できます。