タスクの作成

• コンソール
• CLI
• API

• 1. ナビゲーション・メニューを開き、「監視および管理」.をクリックします「フリート・アプリケーション管理」で、「アクションおよびコントロール」をクリックします。
  2. 「Runbooks」ページで、「Tasks」タブをクリックします。
  3. 「タスクの作成」をクリックします。
  4. 「タスクの作成」パネルで、タスクの一意の名前と説明を入力します。機密情報を入力しないでください。
  5. 「アクション・タイプ」で、「スクリプトの実行」を選択してオブジェクト・ストレージからスクリプトをアタッチするか、「コマンド」の下にスクリプトをインラインで追加できます。ステップ15を参照してください。
  6. (オプション)タスクが属する製品または製品スタック、およびタスクが実行されるOSのタイプを選択します。
  7. タスクがターゲットの検出を目的としている場合:
     1. 「検出出力タスクとしてマーク」トグルをオンにします。このアクションにより、フリート・アプリケーション管理は、完了後にタスクからソフトウェア・インベントリ情報を収集できます。
     2. 「検出出力テンプレートのダウンロード」をクリックして、タスク出力が検出テンプレート形式と一致することを確認します。
        ダウンロードした検出テンプレートは、検出スクリプトをコーディングするためのガイドとして使用します。テンプレートの属性の詳細は、検出出力テンプレートについてを参照してください。
  8. パッチの適用タスクの場合は、「このタスクを実行するにはパッチが必要です」トグルをオンにします。
     オンにすると、フリート・アプリケーション管理によって、タスクの推奨パッチの詳細が移入されます。詳細は、patches.jsonファイルを参照してください。このスクリプトは、patches.jsonファイルを読み取ってすべてのパッチを取得し、環境変数DATA_DIRを使用して、フリート・アプリケーション管理によってコンピュート・インスタンスにダウンロードされたパッチの場所を知ることができます。
  9. タスク実行用のスクリプトを追加するには、「スクリプトの選択」の横にある「参照」をクリックします。
  10. 「ファイルの選択」パネルで、次のいずれかのオプションを選択します。
      • オブジェクト・ストレージ・バケットから選択: オブジェクト・ストレージからスクリプトを選択して(すでにアップロードされている場合)、ステップ11にスキップします。
      • ファイルのアップロード: スクリプトをオブジェクト・ストレージにアップロードして選択し、ステップ12にスキップします。
  11. 「オブジェクト・ストレージ・バケットから選択」を選択した場合:
      1. スクリプトとともにオブジェクト・ストレージ・バケットを含むコンパートメントを選択し、バケットを選択します。
      2. スクリプト・ファイルの横にあるチェック・ボックスを選択し、「選択」をクリックします。ステップ13に進みます。
  12. 「ファイルのアップロード」を選択した場合:
      1. ファイル・システムから「ファイルのドロップ」ボックスにファイルをドラッグするか、ファイルを参照します。
      2. ファイルのアップロード先のオブジェクト・ストレージ・バケットを含むコンパートメントを選択し、バケットを選択します。
      3. スクリプト・ファイルの横にあるチェック・ボックスを選択し、「選択」をクリックします。ステップ13に進みます。
      4. (オプション)「オブジェクト名接頭辞」に、アップロードするファイルの接頭辞を指定して、オブジェクト・ストレージから選択するときに簡単に識別します。
      5. 「アップロードして選択」をクリックしてスクリプトをバケットに格納し、タスクのスクリプトを選択します。
  13. 「タスクの作成」パネルで、タスクに入力変数が必要な場合は、「入力変数の追加」トグルをオンに切り替えてから、次の詳細を入力します:
      1. 変数の一意の名前と説明を入力します。機密情報を入力しないでください。
      2. 「タイプ」で、文字列または出力変数を選択します。たとえば、変数値を別のタスクの入力変数として使用する場合は、出力変数としてタイプを選択します。
      必要に応じて、入力変数を追加します。
  14. タスクで出力変数が生成される場合は、「出力変数の追加」トグルをオンにし、変数の一意の名前を入力します。必要に応じて、出力変数を追加します。
  15. (オプション)タスクの実行が複数のファイルに基づいている場合は、「コマンド」ボックスに、スクリプトの実行を開始するコマンドを指定します。スクリプトの実行方法をフリート・アプリケーション管理に知らせるコマンドを指定します。スクリプトは、ZIPファイル、JARファイル、EXEファイル、またはインスタンスで実行できるその他のプログラムです。タスクに定義された変数は、プレース引数またはキー値引数としてスクリプトに渡すことができます。変数を引数として渡す場合は、先頭に「$」を付けます。たとえば、ZIPファイルおよびJARファイルを使用するには:
      • unzip zippedfile.zipコマンドを入力してすべてのファイルを含むファイルを解凍し、./main.shコマンドを入力して実行を開始します。
      • コマンドに変数を渡すには、コマンドライン引数として指定します。次のタイプのコマンドライン引数を参照してください。
        • 静的引数の場合、引数として直接指定します(たとえば、タスク・スクリプトでタイムアウト値が想定される場合)、引数は次のようになります: ./main.sh 10s
        • タスクに構成されているものに基づく動的引数(たとえば、タイムアウトおよびbackuptypeを想定する場合)の場合、引数は次のようになります: ./main.sh $timeout $backuptype
        • 静的引数と動的引数の組合せの場合、引数は次のようになります: ./main.sh 10s $backuptype
      • 動的引数(backuptypeおよびtimeout)に次のJARコマンドを入力します。

        java -jar ApplicationBackup.jar $backuptype $timeout

  16. (オプション)製品または製品スタックに定義されていない場合は、Vaultで作成した資格証明名を選択します。
      重要
      
      タスクに資格証明が必要な場合は、メタデータ管理で資格証明を作成し、フリート、リソースまたはターゲット資格証明の詳細を指定する必要があります。その後、フリート・アプリケーション管理は、これらの詳細をランブック・タスク実行に渡します。
  17. 「タスク・プロパティ」で、次の詳細を入力します:
      • 失敗時の最大再試行回数: タスクが失敗したときに再試行する回数を指定します。
      • タイムアウト: タスクが失敗した場合のタイムアウト値(秒単位)を指定します。
  18. 「作成」をクリックします。

  検出出力テンプレートについて

  次に、フリート・アプリケーション管理の検出出力テンプレート属性の詳細を示します。

  • targets: 特定の製品のターゲットが含まれます。検出ランブックは、製品または製品スタックの複数のターゲットを返すことができます。
  • product: スタックは異なる製品に対して複数のターゲットを返すことができるため、製品の検出ランブックのオプション属性であり、製品スタックの検出ランブックには必須です。したがって、フリート・アプリケーション管理では、ターゲットがスタックのどの製品に属しているかを認識する必要があります。検出ランブックの製品属性を指定しない場合、フリート・アプリケーション管理では、ランブックに関連付けられた製品を使用してターゲットを製品にマップします。
  • target_name: ターゲットのホーム・ディレクトリ。
  • version: 製品のバージョン
  • properties: 製品のプロパティ。パッチ適用ランブックの条件ビルダーでこれらを使用して、タスクを条件付きで実行します。
  • components(コンポーネント): 製品に関連付けられたコンポーネント。パッチ適用ランブックの条件ビルダーでこれらを使用して、タスクを条件付きで実行します。
  • component (properties): コンポーネントのプロパティ。パッチ適用ランブックの条件ビルダーでこれらを使用して、タスクを条件付きで実行します。
  • resource_name: コンピュート・インスタンスの名前(オプション)。
  • installed_patches: ターゲットにすでにインストールされているパッチが含まれています。
  • available_patches: ターゲットへのインストールに使用可能なパッチが含まれます(オプション)。

• oci fleet-apps-management fleet-apps-management-runbooks task-record createコマンドおよび必要なパラメータを使用して、ランブック・タスクを作成します:

  oci fleet-apps-management fleet-apps-management-runbooks task-record create [OPTIONS]

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

• CreateTaskRecord操作を実行して、ランブック・タスクを作成します。