ランブックの処理

フリート・アプリケーション管理でランブックを使用して、フリート・リソースに対してライフサイクル操作を実行します。

重要

ライフサイクル操作に必要なフリート・アプリケーション管理プラグインがフリート・アプリケーション管理の外部で無効になっている場合、操作は失敗します。たとえば、フリート・アプリケーション管理プラグインまたはOS管理ハブ・プラグインのいずれかが、フリート・アプリケーション管理によって管理されているリソースで有効になっていない場合、エラーが発生します。
  • 「フリート」リスト・ページで、操作するフリートを選択します。「フリート」リスト・ページまたは特定のフリートの検索に関するヘルプが必要な場合は、フリートのリストを参照してください。

    フリート詳細ページで、「アクション」を選択し、「プロセス・ランブック」を選択します。

    ランブックの処理は次のページで構成されます。

    次の各ワークフローを順番に実行します。「前」を選択して、前のページに戻ることができます。

    1. ランブックの追加

    「ランブックの追加」ページで、フリートに必要なランブックを追加します。

    1. 「名前」で、必要に応じて名前を編集します。デフォルトでは、フリート・アプリケーション管理は、ライフサイクル操作、日付および時間を含む英数字のハイフン名を設定します。
    2. 「コンパートメントに作成」で、プロセスを実行するコンパートメントを選択します。
    3. 「ランブック処理期間」で、トグルをオンにしてランブックの推定時間を含め、期間を指定します。
      ノート

      期間を指定する場合は、参加リソースの数とメソッド(パラレルまたはローリング)を考慮します。これらの要因は、適切なスケジュール期間の計算に役立ちます。
    4. 「ランブックの追加」を選択します。
    5. 「ランブックの追加」パネルで、フリートに含めるランブックを選択します。
      ノート

      アクティブなランブックのみが表示されます。
    6. ランブックのバージョンを選択します。
      パッチ適用、検出、プロビジョニングおよびカスタム・ライフサイクル操作のためのランブックを使用できます。
    7. 「ランブックの追加」を再度選択します。
    8. 別のコンパートメントからランブックを追加するには、コンパートメントを選択し、前述のステップを繰り返します。
    フリートにランブックを追加すると、「ランブックの追加」表に表示されます。ランブックは、表に示されている順序に基づいて実行されます。次のことができます。
    • ランブック名を選択して詳細を表示します。
    • ランブックの行の「アクション」メニューから、順序を変更します。
    「次へ」を選択して続行します。

    タグ付け

    リソースを作成する権限を持つ場合、そのリソースにフリーフォーム・タグを適用する権限もあります。定義済タグを適用するには、タグ・ネームスペースを使用する権限を持つ必要があります。タグ付けの詳細は、リソース・タグを参照してください。 タグを適用するかどうかがわからない場合は、このオプションをスキップするか、管理者に問い合せてください。タグは後で適用できます。

    「次へ」を選択して、次のステップに進みます。

    2. ランブック・パラメータ

    「ランブック・パラメータ」ページで、ランブック・タスクに1つ以上の引数(定義されている場合)を入力します。

    ランブックによって、パラメータは異なる場合があります。

    • パッチ適用または検出のランブック:
      • 引数名: タスクに関連付けられた引数名を選択します。
      • 引数値: 値を入力してデフォルト値を変更します。
      • ランブックで適用可能な場合は常に同じ値を適用: ランブック・タスクで同じ値を使用するには、このスイッチをオンにします。スイッチをオンにしない場合は、各ランブック・タスクの引数名と値を指定します。
    • プロビジョニング・ランブック:

      ランブックとそのタスク(データベースまたはコンピュート・リソースのプロビジョニングなど)に基づいて、フリート・アプリケーション管理には関連する構成フィールドが表示されます。プロビジョニングされる特定のリソースに構成を調整できます。

      ノート

      • プロビジョニング中に、Terraformパッケージまたは構成ファイル(JSON、YAML、.tfファイルなど)に関連付けられた構成を表示および変更できます。
      • 構成は、基礎となるファイルの内容(キーと値のペアなど)に基づいて移入される動的フォームとして表示されます。
      • フォーム・フィールドは、Terraformパッケージのschema.yamlファイルから生成されます。スキーマにデフォルト値が定義されている場合、フィールドは事前移入されます。それ以外の場合は、このフィールドは空白で入力できます。schema.yamlファイルの詳細は、「検証用のメタ・スキーマ」を参照してください。
      ランブック・タスクを構成するには、次のいずれかのオプションを選択します。
      • 既存の選択: 既存の構成カタログ項目を選択します。ランブックでは、選択した構成が変更なしで使用されます。このステップでは構成を変更できず、フォームは表示されません。
      • 新規作成: 「変更」を選択し、「構成カタログ・アイテムの作成」パネルに構成値を直接入力してカタログ・アイテムを作成します。パネルには、ランブック・タスクに添付されたTerraformカタログ・アイテム・ファイルのschema.yamlファイルのコンテンツからレンダリングされた動的フォームが表示されます。この新しい構成は、今後使用するためにObject Storageに保存できます。プライベート・カタログ・アイテムの作成を参照してください。フリート・アプリケーション管理では、カタログ項目を作成し、プロビジョニング・タスクに関連付けます。
        ノート

        構成フィールドは、リソース・タイプ(データベース、コンピュート、通知、イベントなど)に基づいて適応します。たとえば、通知サービスのプロビジョニングでは電子メール・アドレスのフィールドを要求し、データベース・プロビジョニング・ランブックでは「アラームの作成が有効」や「イベントの作成」などの設定が表示される場合があります。

        「構成して選択」を選択して構成の変更を確認し、ランブックの構成を作成して選択します。

    「次へ」を選択して続行します。

    3. レビュー

    「確認」ページで、次を実行します。
    • ランブックの構成を確認します。
    • 設定を変更するには、「基本情報の編集」を選択します。
    • ランブックを変更するには、「ランブックの編集」を選択します。フィールドの説明は、ランブックの作成を参照してください。
    • 入力変数または出力変数を変更するには、「パラメータの編集」を選択します。フィールドの説明は、タスクの作成を参照してください。
    • タグを更新するには、「タグの編集」を選択します。

    すべての設定を確認したら、「作成」を選択します。

    ランブックは選択した操作の実行を開始し、その進行状況を「ランブック・プロセス」タブで確認できます。ランブック・プロセスのリストを参照してください。

  • このタスクはCLIを使用して実行できません。

    フリート・アプリケーション管理CLIコマンドのフラグおよび変数オプションの完全なリストは、フリート・アプリケーション管理用のCLIを参照してください。

  • APIを使用してこのタスクを実行することはできません。