カスタムタスク#

Lagoonでは、環境、プロジェクト、グループレベルでカスタムタスクを定義することができます。現在、これはGraphQL APIを通じて行われ、UIで公開されています。

カスタムタスクの定義#

タスクを定義する際には、いくつかのことを決定する必要があります。

どのタスクを実行しますか？#

ほとんどの場合、実行するカスタムタスクは、アプリケーションのコンテナの一つでシェルで実行されるものです。

例えば、Node.jsアプリケーションでは、nodeコンテナでyarn auditを実行することに興味があるかもしれません。この場合、コマンドは単純にyarn auditとなります。

このタスクはどこで実行されますか？#

このタスクがどこで実行されるかを定義する必要があります -- これは二つのことを意味します。まず、どのプロジェクトまたは環境でタスクを実行するか、そして、どのサービスで行うかです。

たとえば、yarn auditタスクを特定のプロジェクト(この例ではプロジェクトのIDを42としましょう)の任意の環境で実行可能にしたいと考えているとしましょう。そのため、タスク定義を作成する際には、下記で説明するように、プロジェクトのIDを指定します。

2つ目の質問は、どの環境をタスクの対象とするかということです。あなたが設定するときにあなたのプロジェクトを設定する際に、docker-compose.ymlでいくつかのサービスを指定します。このサービス名を使用して、コマンドが実際にどこで実行されるかを決定します。

このタスクを実行できるのは誰ですか？#

タスクシステムへのアクセス権はプロジェクトロールに対応した3つのレベルがあります。ゲスト、デベロッパー、メンテナー -- 最も制限的なものから最も制限の少ないものまで、各ロールはそれより下のロールで定義されたタスクを呼び出すことができます(デベロッパーはゲストのタスクを見ることができ、メンテナーはすべてのタスクを見ることができます)。

タスクの定義#

タスクはaddAdvancedTaskDefinitionミューテーションを呼び出すことで定義されます。重要なことは、これは単にタスクを_定義するだけで、それを呼び出すわけではありません。それは単にそれを環境で実行可能にするだけです。

概念的には、呼び出しは次のようになります。

新しいタスクを定義する

mutation addAdvancedTask {
    addAdvancedTaskDefinition(input:{
    name: string,
    confirmationText: string,
    type: [COMMAND|IMAGE],
    [project|environment]: int,
    description: string,
    service: string,
    command: string,
    advancedTaskDefinitionArguments: [
      {
        name: "ENVIROMENT_VARIABLE_NAME",
        displayName: "Friendly Name For "Variable",
        type: [文字列 | 環境ソース名 | 自己を除く環境ソース名]
      }
    ]
  }) {
    ... on AdvancedTaskDefinitionImage {
      id
      name
      description
      service
      image
      confirmationText
      advancedTaskDefinitionArguments {
        type
        range
        name
        displayName
      }
      ...
    }
    ... on AdvancedTaskDefinitionCommand {
      id
      name
      description
      service
      command
      advancedTaskDefinitionArguments {
        type
        range
        name
        displayName
      }
      ...
    }
  }
}

フィールドnameとdescriptionは直訳です。これらは主にUIで使用されるタスクの名前と説明です。

typeフィールドについては説明が必要です - 現時点では、プラットフォーム管理者のみがIMAGEタイプのコマンドを定義できます - これは、既存のサービスを対象にするのではなく、特定のタスクイメージをタスクとして実行することを可能にします。しかし、ほとんどのタスクはCOMMANDタイプになります。

[project|environment]フィールドのセットは、タスクをprojectまたはenvironmentに関連付ける(使用するキーによります)ことで、その値が id. 私たちがyarn auditのために考えているケースでは、IDが42のprojectを対象としていることを明示します。

私たちがタスクでターゲットにしたいサービスをserviceフィールドに置き、commandは私たちが実行したい実際のコマンドです。

タスクに渡される引数#

Lagoon UI経由でタスクを呼び出すユーザーにより柔軟性を提供するために、タスク引数の定義をサポートしています。これらの引数はテキストボックスまたはドロップダウンとして表示され、タスクを呼び出すために必要です。

以下は、2つの引数を設定する方法の例です。

タスク引数の定義

advancedTaskDefinitionArguments: [
      {
        name: "ENV_VAR_NAME_SOURCE",
        displayName: "環境源",
        type: ENVIRONMENT_SOURCE_NAME

      },
      {
        name: "ENV_VAR_NAME_STRING",
        displayName: "エコー値",
        type: STRING
        }
    ]
  })

このフラグメントは、システムが現在サポートしている両方のタイプの引数を示しています。最初のENV_VAR_NAME_SOURCEはENVIRONMENT_SOURCE_NAMEタイプの例で、これはUIのユーザーにプロジェクト内の異なる環境のドロップダウンを提示します。もし私たちが許可したくない場合は、呼び出し環境で実行するタスク(例えば、他の環境からデータベースをインポートしたい場合など)については、ENVIRONMENT_SOURCE_NAME_EXCLUDE_SELFを使用して環境リストを制限することができます。二つ目のENV_VAR_NAME_STRINGはSTRING型で、ユーザーにテキストボックスを記入するように促します。

ユーザーが選択した値は、タスクが実行されたときにCOMMAND型のタスクで環境変数として利用可能になります。

タスク引数

システム全体のタスク#

プラットフォームの管理者は、システム全体のタスクを登録することができます。これらのタスクはすべての環境で表示され、ユーザーがそれらを呼び出す権限によって制限されます。

システム全体のタスクを作成する方法は、他のタスクタイプとほぼ同じですが、2つの例外があります。

まず、addAdvancedTaskDefinitionミューテーションの中でsystemWide: trueフィールドを設定します。

次に、groupName、project、またはenvironmentを指定していないことを確認します - これらのフィールドは特定のコンテキストをターゲットにするために使用されるため、これらを指定すると目的を逸脱することになります。

確認#

confirmationTextフィールドにテキストがあると、ユーザーがタスクを実行できるようになる前に、UIに確認モーダルとともに表示されます。タスク確認

タスクの呼び出し#

タスクが定義されていると、タスクはLagoon UIのタスクドロップダウンに表示されるはずです。

また、invokeTask ミューテーションを使用してGraphQL apiからも呼び出すことができます。

タスクの呼び出し

mutation invokeTask {
  invokeRegisteredTask(advancedTaskDefinition: int, environment: int) {
    status
  }
}

invokeTaskは常に_特定の環境_でタスクを呼び出すことに注意してください。

例#

では、yarn auditの例を設定してみましょう。

タスク定義ミューテーション

mutation runYarnAudit {
 addAdvancedTaskDefinition(input:{
    name:"Run yarn audit",
    project: 42,
    type:COMMAND,
    permission:DEVELOPER,
    description: "Runs a 'yarn audit'",
    service:"node",
    command: "yarn audit"})
    {
        id
    }
}

これにより、私たちのプロジェクト(42)のタスクが定義されます。これを実行すると、タスク定義のIDが返されます(たとえば、9とします)

このタスクは、DEVELOPERまたはMAINTAINERの役割を持つ誰でもUIから実行できるようになります。

タスクリスト