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

パイプラインの構成

パイプラインの構成には、パイプラインのトリガーメソッド、パイプラインの実行環境、リソース記述 YAML、DingTalk ロボット通知の 4 つの主要項目が含まれます。アプリケーションまたは環境の作成時に、パイプラインのトリガーメソッドと実行環境を構成できます。作成後、編集ボタンをクリックして 4 つすべての項目を構成できます。

パイプラインのトリガーメソッド

Serverless Application Center では、パイプラインをトリガーする Git イベントをカスタマイズできます。Serverless Application Center は Webhook を使用して Git イベントを受信します。トリガールールに一致するイベントを受信すると、パイプラインの YAML 構成に従ってパイプラインを作成し、実行します。次のトリガーメソッドがサポートされています：

• ブランチトリガー：環境は特定のブランチに関連付けられている必要があります。これは、指定されたブランチ内のすべての Push イベントに一致します。

• タグトリガー：指定されたタグ式に対するすべてのタグ作成イベントに一致します。

• ブランチマージトリガー：指定されたソースブランチから環境に関連付けられたターゲットブランチへのマージ/プルリクエストイベントに一致します。

パイプラインの実行環境

パイプライン実行環境には、デフォルトの実行環境と専用の実行環境の 2 つのモードがあります。

デフォルトの実行環境

デフォルトの実行環境では、プラットフォームがパイプラインリソースを完全に管理します。パイプラインの実行中に発生するコストは Alibaba Cloud Function Compute が負担するため、料金を支払う必要はありません。各パイプラインタスクは独立したサンドボックスコンテナで実行され、プラットフォームはパイプライン実行環境のセキュリティと隔離を保証します。デフォルトの実行環境の制限は次のとおりです：

• インスタンス仕様：4 vCPU、8 GB メモリ。

• 一時ディスク領域：10 GB。

• タスク実行タイムアウト：15 分。

• リージョンの制限：テンプレートからの直接デプロイメント、または GitHub ソースからのデプロイメントには、シンガポールリージョンを使用します。Gitee、パブリック GitLab、または Codeup ソースの場合は、中国 (杭州) リージョンを使用します。

• ネットワークの制限：固定 IP アドレスと CIDR ブロックはサポートされていません。IP アドレスホワイトリストを使用した特定のウェブサイトへのアクセスはサポートされていません。ご利用の VPC 内のリソースへのアクセスはサポートされていません。

専用の実行環境

専用の実行環境は、ご利用のアカウントでパイプラインタスクを実行し、より多くのカスタマイズオプションを提供します。権限付与に基づき、Serverless Application Center は専用の実行環境のタスクを完全に管理し、Function Compute インスタンスをリアルタイムでスケジュールして、ご利用のアカウントでパイプラインを実行します。デフォルトの実行環境と同様に、専用の実行環境は完全にサーバーレスであり、基盤となるインフラストラクチャを管理する必要はありません。

専用の実行環境では、次のカスタマイズオプションが提供されます：

• リージョンとネットワーク：実行環境のリージョンと VPC を指定できます。これにより、プライベートコードリポジトリ、アーティファクトリポジトリ、イメージリポジトリ、プライベート Maven サーバーなどのリソースにアクセスできます。サポートされているリージョンの詳細については、「サービスエンドポイント」をご参照ください。

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

  説明

  vCPU コア数とメモリ (GB) の比率は 1:1 から 1:4 の間でなければなりません。

• 永続ストレージ：NAS および OSS のマウント設定を構成できます。たとえば、NAS マウントを使用してファイルをキャッシュし、ビルドを高速化できます。

• ログ：SLS プロジェクトと Logstore を指定して、パイプライン実行ログの永続化を有効にできます。

• タイムアウト：パイプラインタスクの実行タイムアウトをカスタマイズできます。デフォルトは 600 秒で、最大は 86,400 秒です。

リソース記述 YAML

Serverless Application Center は、Serverless Devs 開発者ツールと深く統合されています。Serverless Devs のリソース記述ファイルを使用して、サービスのリソース構成を宣言できます。YAML 仕様の詳細については、「Serverless Devs YAML specification」をご参照ください。デフォルトのリソース記述ファイル名は s.yaml ですが、別のファイル名を指定することもできます。リソース記述ファイルを指定した後、パイプラインで 2 つの方法で使用できます：

• @serverless-cd/s-deploy デプロイメントプラグインを使用する場合、プラグインは指定されたリソース記述ファイルを自動的にデプロイメントに使用します。これは、Serverless Devs の操作に -t/--template コマンドを追加することで機能します。たとえば、次のコードでは、指定されたリソース記述 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.deployFile }} を使用して特定のリソース記述ファイル名を参照できます。たとえば、次のコードは、ファイルが指定されている場合は指定されたファイルを使用して s plan コマンドを実行します。それ以外の場合は、デフォルトの s.yaml ファイルを使用して s plan コマンドを実行します。

- 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 ロボット通知

この構成を有効にした後、DingTalk ロボットの Webhook アドレス、署名キー、通知ルール、および カスタムメッセージを構成する必要があります。通知が必要なすべてのタスクをここで管理することも、パイプライン YAML で各タスクの通知を個別に有効にすることもできます。ここでの全体的な通知構成を完了した後、パイプライン詳細セクションで各タスクの通知設定をさらに詳細に設定できます。

パイプラインの詳細

パイプラインの詳細セクションでは、パイプラインフローを構成し、タスクとその関係の詳細を指定できます。プラットフォームはデフォルトのパイプラインフローを自動的に生成し、これを編集できます。

パイプラインは YAML を使用して管理されます。利用可能な構成方法は、プラットフォームホストとリポジトリから読み取りの 2 つです：

プラットフォームホスト

デフォルトでは、パイプライン YAML はプラットフォームによってホストされます。これは、構成がプラットフォーム上で一元管理され、更新後の次のデプロイメントで有効になることを意味します。

リポジトリから読み取り

パイプラインの YAML 記述ファイルは、リモートの Git リポジトリに保存されます。コンソールで編集して保存すると、プラットフォームは変更をリアルタイムで Git リポジトリにコミットします。このコミットはパイプラインの実行をトリガーしません。コードリポジトリ内のイベントがパイプラインをトリガーすると、プラットフォームは指定した Git リポジトリの YAML ファイルを使用してパイプラインを作成し、実行します。

パイプラインの詳細セクションの上部で、リポジトリから読み取りを指定し、次の図に示すように YAML ファイル名を入力できます。

パイプラインの詳細セクションの本体は、左側の補助ツールエリアと右側の YAML 編集エリアで構成されています：

• YAML 編集エリア：パイプライン YAML を直接編集して、パイプラインフローを変更できます。詳細については、「YAML ファイルを使用したパイプラインの記述」をご参照ください。

• 補助ツールエリア：YAML の編集に役立つツールを提供します。これには以下が含まれます：

  • フロープレビュー：パイプラインフローの視覚的なプレビューと簡単な編集機能を提供します。

  • タスクテンプレート：一般的に使用される一連のタスク YAML テンプレートを提供します。

セクションの右上隅には、保存、全画面表示、リセットの 3 つのボタンがあります：

• 保存ボタンは、ページ上の YAML に加えられた変更を保存し、パイプライン YAML に同期します。

• 全画面表示ボタンは、メインの編集エリアを全画面に拡大します。

• リセットボタンは、YAML が最後に保存されてから加えられたすべての変更をキャンセルし、初期状態に戻します。

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

特定のパイプライン実行バージョンをクリックして、その詳細を表示できます。この情報により、実行ログとステータスをすばやく確認でき、パイプラインの実行状況を理解したり、問題をトラブルシューティングしたりするのに役立ちます。

パイプラインビルド環境ランタイムのアップグレード

パイプラインのランタイムバージョンは、runtime-setup パイプラインプラグインを使用するか、リソース記述ファイル内の環境変数を変更することで設定できます。