Function Compute:パイプラインの管理

パイプラインの設定

パイプラインを設定するには、パイプライントリガーモード、YAML、DingTalkチャットボット通知設定、およびパイプライン実行環境のパラメーターを設定する必要があります。 アプリケーションと環境を作成するときは、パイプライントリガーモードとパイプライン実行環境パラメーターのみを設定できます。 アプリケーションと環境を作成したら、[パイプライン管理] タブの [パイプライン構成] の右側にある [変更] をクリックして、前述の4つのパラメーターを変更できます。

パイプライントリガーモード

Serverless Application Centerでは、パイプラインのGitイベントをトリガーするメソッドを指定できます。 Serverless Application Centerは、Webhookを使用してGitイベントを受信します。 指定されたトリガー条件を満たすイベントが受信されると、サーバーレスアプリケーションセンターは、指定したYAMLファイルに基づいてパイプラインを作成して実行します。 次のトリガーモードがサポートされています。

• ブランチによってトリガーされる: 環境は特定のブランチに関連付けられている必要があり、ブランチ内のすべてのプッシュイベントが一致します。

• タグによってトリガーされる: 特定のタグ式のすべてのタグ作成イベントが一致します。

• 分岐マージによってトリガーされる: ソース分岐から環境が関連付けられている宛先分岐への要求イベントのマージとプルが一致します。

パイプライン実行環境

このパラメーターは、[デフォルト環境] または [カスタム環境] に設定できます。

デフォルト環境

Pipeline Execution EnvironmentパラメーターをDefault Environmentに設定すると、Serverless Application Centerはパイプラインリソースを完全に管理し、Function Computeはパイプラインの実行中に発生する料金を負担します。料金を支払う必要はありません。 パイプラインの各タスクは、独立したサンドボックス化された仮想マシンで実行されます。 Serverless Application Centerは、パイプライン実行環境の分離を保証します。 次の項目は、デフォルトの環境に課される制限を示しています。

• インスタンスの仕様: 4 vCPUと8 GBのメモリ。

• 一時ディスク容量: 10 GB。

• タスク実行タイムアウト時間: 15分。

• リージョン: GitHubのテンプレートまたはソースコードを使用して環境を作成する場合は、シンガポールリージョンを指定します。 Gitee、GitLab、またはCodeupを使用して環境を作成する場合は、中国 (杭州) リージョンを指定します。

• ネットワーク: 固定IPアドレスまたはCIDRブロックは使用できません。 特定のWebサイトにアクセスするようにIPアドレスホワイトリストを設定することはできません。 仮想プライベートクラウド (VPC) のリソースにアクセスすることはできません。

カスタム環境

パイプライン実行環境パラメーターをカスタム環境に設定した場合、パイプラインはAlibaba Cloudアカウントで実行されます。 デフォルト環境と比較して、カスタム環境はより多くのカスタム機能を提供します。 Serverless Application Centerは、カスタム環境でタスクを完全に管理し、Function Computeインスタンスをリアルタイムでスケジュールして、承認に基づいてパイプラインを実行します。 既定の環境と同様に、カスタム環境にはサーバーレス機能があり、インフラストラクチャを維持する必要がありません。

カスタム環境は、次のカスタム機能を提供します。

• リージョンとネットワーク: 実行環境のリージョンとVPCを指定して、内部コードリポジトリ、アーティファクトリリポジトリ、イメージリポジトリ、およびMaven内部リポジトリにアクセスできます。 サポート対象リージョンの詳細については、「サポート対象リージョン」をご参照ください。

• インスタンス仕様: 実行環境のCPUとメモリの仕様を指定できます。 たとえば、より大きな仕様のインスタンスを指定して、ビルドプロセスを高速化できます。

  説明

  vCPU容量とメモリ容量 (GB) の比率は、1:1から1:4の範囲です。

• 永続ストレージ: Apsara File storage NAS (NAS) またはObject Storage Service (OSS) のマウントを設定できます。 たとえば、NASを使用してファイルをキャッシュし、ビルドプロセスを高速化できます。

• ロギング: Simple Log ServiceプロジェクトとLogstoreを指定して、パイプラインの実行ログを保持できます。

• タイムアウト期間: パイプラインタスクのカスタムタイムアウト期間を指定できます。 既定値：600。 最大値: 86400。 単位は秒です。

YAML

Serverless Application Centerは、Serverless Devsと統合されています。 Serverless DevsのYAMLファイルを使用して、アプリケーションのリソース構成を定義できます。 YAMLファイルの構文については、「YAML構文」をご参照ください。 デフォルトのYAMLファイルの名前はs.yamlです。 別のYAMLファイルを指定することもできます。 YAMLファイルを指定した後、次の方法を使用してパイプラインで使用できます。

• デプロイメントプラグイン @ serverless-cd/s-deployを使用すると、プラグインは指定されたYAMLファイルを自動的に使用します。 -t/-- templateコマンドは、Serverless Devsの操作命令に追加されます。 次の例では、指定されたYAMLファイルはdemo.yamlで、プラグインによって実行されるコマンドはs deploy -t demo.yamlです。

- name: deploy
  context:
    data:
      deployFile: demo.yaml
      steps:
      - plugin: '@serverless-cd/s-setup'
      - plugin: '@serverless-cd/checkout'
      - plugin: '@serverless-cd/s-deploy'
  taskTemplate: serverless-runner-task

• スクリプトを使用して実行する場合は、${{ ctx.data.de ployFile }} を使用して特定のYAMLファイルを参照できます。 次の例では、YAMLファイルを指定した場合、s planコマンドは指定されたファイルを使用して実行されます。 それ以外の場合、s planコマンドはデフォルトのs.yamlファイルを使用して実行されます。

- name: pre-check
  context:
    data:
      steps:
      - run: s plan -t ${{ ctx.data.deployFile || s.yaml }}
      - run: echo "s plan finished."
  taskTemplate: serverless-runner-task

DingTalkチャットボット通知の設定

この機能を有効にした後、Webhookアドレス、署名キー、失敗時のみ通知、カスタムメッセージのパラメーターを設定します。 通知を必要とするタスクを一元管理できます。 パイプラインのYAMLファイルを使用して、各タスクの通知を有効にすることもできます。 通知を設定した後、[パイプラインの詳細] セクションで各タスクの通知を設定できます。

パイプラインの詳細セクション

[パイプラインの詳細] セクションでは、パイプラインフロー、パイプライン内のタスク、およびタスク間の関係を設定できます。 プラットフォームは自動的にデフォルトのパイプラインプロセスを生成し、それに基づいて設定を変更できます。

YAMLを使用してパイプラインを管理できます。 [プラットフォームでのホスティング] または [リポジトリからの読み取り] をパイプラインパスとして選択できます。

Hosting on Platform

デフォルトでは、パイプラインのYAMLファイルは、サーバーレスアプリケーションセンターで一元管理されています。 パイプラインのYAMLファイルを更新すると、新しい設定は次の配置で有効になります。

リポジトリからの読み取り

パイプラインのYAMLファイルは、Gitリポジトリに保存されます。 Function Computeコンソールで設定を変更して保存した後、Serverless Application CenterはリアルタイムでGitリポジトリへの変更をコミットします。 これはパイプラインの実行をトリガーしません。 コードリポジトリ内のイベントがパイプラインの実行をトリガーすると、Serverless Application Centerは、Gitリポジトリ内の指定されたYAMLファイルを使用してパイプラインを作成および実行します。

[パイプラインの詳細] セクションの上部で [リポジトリからの読み取り] を選択し、YAMLファイルの名前を入力します。 以下の図は一例です。

パイプラインの詳細セクションは、左側のツール領域と右側のYAML編集領域で構成されています。

• YAML編集領域: パイプラインのYAMLファイルを編集して、パイプラインを変更できます。 詳細については、「YAMLファイルを使用したパイプラインの説明」をご参照ください。

• ツール領域には、YAMLファイルを編集するための補助ツールがあります。 次のタブが含まれています。

  • プロセスプレビュータブ: パイプラインプロセスをプレビューおよび変更できます。

  • タスクテンプレートタブ: 提供されている一般的なYAMLテンプレートを表示できます。

サブセクションの右上隅に、[保存] 、[全画面] 、および [リセット] ボタンが表示されます。

• [保存] をクリックすると、すべての変更をYAMLファイルに保存できます。 その後、保存されたすべてのデータがパイプラインのYAMLファイルに同期されます。

• [全画面] をクリックすると、編集サブセクションが全画面として表示されます。

• [リセット] をクリックすると、YAMLファイルの最新の変更を元に戻します。

パイプラインの実行履歴を表示する

パイプラインの実行バージョンをクリックすると、パイプラインの実行の詳細が表示されます。 次に、詳細を使用して、パイプラインの実行ログとステータスを表示し、問題をトラブルシューティングできます。

パイプラインのランタイムを更新する

パイプラインのランタイムバージョンを指定するには、runtime-setupプラグインを使用するか、YAMLファイルの変数を変更します。