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はパイプラインの実行中に発生する料金を負担します。料金を支払う必要はありません。 パイプラインの各タスクは、独立したサンドボックスVM上で実行されます。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とメモリの比率は1:1から1:4の範囲である必要があります。 メモリ容量はGB単位で測定されます。

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

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

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

YAML

Serverless Application Centerは、Serverless Devsと統合されています。 Serverless Devsの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ファイルを使用して、各タスクの通知を有効にすることもできます。 通知を設定した後、[パイプラインの詳細] セクションで各タスクの通知を設定できます。

パイプライン環境変数の設定

[パイプライン環境変数] セクションで、[変更] をクリックします。 表示されるパネルで、設定方法を選択し、環境変数を設定し、[OK] をクリックします。

• フォームを使用した編集 (デフォルト)

  1. [変数の追加] をクリックします。

  2. 環境変数のキーと値のペアを設定します。

     • variable: カスタム変数を入力します。

     • value: 変数値を入力します。

• JSON形式で編集

  1. [JSON形式で編集] をクリックします。

  2. コードエディターで、次のJSON形式でキーと値のペアを入力します。

     {
         "key": "value"
     }

     例：

     {
         "REGION": "MY_REGION",
         "LOG_PROJECT": "MY_LOG_PROJECT"
     }

指定された環境変数は、Serverless Devsパイプラインで有効になります。 ${env(key)} を使用してs.yamlで参照したり、$Keyを使用してシェルコマンドで参照したりできます。

vars:
  region: ${env(REGION)}
  service:
    name: demo-service-${env(prefix)}
    internetAccess: true
    logConfig:
      project: ${env(LOG_PROJECT)}
      logstore: fc-console-function-pre
    vpcConfig:
      securityGroupId: ${env(SG_ID)}
      vswitchIds:
        - ${env(VSWITCH_ID)}
      vpcId: ${env(VPC_ID)}

パイプラインの詳細の設定

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

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

Hosting on Platform

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

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

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

GitリポジトリからYAMLファイルを読み取るには、[パイプラインの詳細] セクションの [変更] をクリックします。 次の図に示すように、表示されるダイアログボックスで、[リポジトリからの読み取り] を選択し、YAMLファイルのパスを入力します。

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

• YAML編集領域: パイプラインのYAMLファイルを編集して、パイプラインプロセスを変更できます。 詳細については、「. yamlファイルを使用してパイプラインを説明する」トピックを参照してください。

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

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

  • タスクテンプレート: 一般的なYAMLテンプレートを提供します。

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

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

• [全画面] をクリックすると、編集領域を最大化できます。

• [リセット] をクリックすると、YAMLファイルを最後に保存したバージョンに復元できます。

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

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

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

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