Alibaba Cloud DevOps:ホストへのアーティファクトのデプロイ

複数環境およびマルチリージョンデプロイ

リージョン間のデプロイ

単一のパイプラインで異なるリージョン (例：米国と日本) のホストにデプロイするには、各リージョンごとに個別のホストグループを作成します。パイプライン内の各ホストグループに対して [VM Deploy] ジョブを追加します。

複数のマイクロサービスのオーケストレーション

複数のマイクロサービスを複数のホストにデプロイするには、各サービスごとに個別のビルドおよびデプロイジョブを持つ単一のパイプラインを使用するか、独立したメンテナンスのためにサービスごとに個別のパイプラインを作成します。ホストごとに個別のパイプラインは必要ありません。ホストグループ内で並列デプロイを設定します。

ランタイムでのデプロイ環境の選択

Flow は、パイプライン実行中にデプロイ環境を動的に選択することをサポートしていません。デプロイ先の環境を制御するには：

1. 各環境 (例：ステージングと本番) ごとに個別のホストグループを作成します。

2. パイプライン内の各ホストグループに対して [VM Deploy] ジョブを追加します。

3. 実行フローを制御するために、デプロイジョブの間に [Manual Confirmation] ノードを挿入します。

適切なデプロイコンポーネントの選択

ECS インスタンスにデプロイする場合、[ECS Application] コンポーネントの代わりに [VM Deploy] コンポーネントを使用します。[VM Deploy] コンポーネントはランナーエージェントを介してホストに接続し、ホストインスタンスと正しく関連付けられます。

デプロイスクリプトの使用方法

[Deployment Script] フィールドはオプションです。空のままにすると、Flow はアーティファクトをホストにダウンロードするだけで、デプロイアクションは実行しません。エラーは報告されません。デプロイを完了するには、展開、設定、および起動ロジックをデプロイスクリプトに記述します。

インラインのデプロイスクリプトには文字数制限があります。スクリプトが制限を超える場合は、シェルスクリプトファイルを Git リポジトリまたはターゲットホストにアップロードし、[Deployment Script] フィールドで呼び出します。例：

sh /home/admin/deploy.sh

単一ホストへの複数サービスの個別デプロイ

複数のサービスを同じホストにデプロイし、それらを個別にリリースしたい場合は、サービスごとに個別のホストグループを作成します。ホストグループには同じホストを含めることができます。パイプライン内の各ホストグループに対して個別のデプロイジョブを設定し、各デプロイを分離するために異なるダウンロードパスと起動スクリプトを指定します。

スクリプトの並列実行

単一のホストで複数のスクリプトを並列実行するには、[Download Artifacts During Deployment] を選択せずに、パイプラインに追加の [VM Deploy] コンポーネントを追加します。このコンポーネントにスクリプトコマンドを直接記述します。異なる [VM Deploy] コンポーネントのスクリプトは、メインのデプロイと並行して実行されます。

デプロイメカニズムとアーティファクト転送

アーティファクトの完全ダウンロード

各ホストデプロイでは、完全なアーティファクトパッケージがダウンロードされます。増分更新はサポートされていません。

ビルドステージとデプロイステージ

ビルド設定の「インストール」ステップは、JDK や Maven などの依存関係をホストではなく Flow ビルドクラスターにインストールします。「アーティファクトのアップロード」ステップは、ファイルをパッケージ化してアーティファクトリポジトリにアップロードします。アーティファクトは、デプロイステージ中にのみホストにダウンロードされます。

静的リソースのホストへのデプロイ

HTML またはその他の静的ファイルをホストにデプロイするには：

1. ビルドステージで、ソースファイルをアーティファクトにパッケージ化します。

2. デプロイスクリプトで、ファイルをターゲットディレクトリに展開します：

   mkdir -p /home/admin/www/html
   tar zxvf /home/admin/app/package.tgz -C /home/admin/www/html/

カスタムディレクトリへのアーティファクトのデプロイ

JAR ファイルまたはその他のアーティファクトを /app/jar/zh のようなカスタムディレクトリにデプロイするには：

mkdir -p /app/jar/zh
tar zxvf /home/admin/app/package.tgz -C /app/jar/zh/
cd /app/jar/zh && sh start.sh

起動スクリプトを事前にターゲットホストに配置することもできます。

Docker Compose を使用したデプロイ

Flow は、Docker Compose を使用したアプリケーションのデプロイをサポートしています。[Deployment Script] で docker-compose コマンドを実行します。

前提条件

デプロイ前に、ターゲットホストに Docker と Docker Compose がインストールされている必要があります。

docker-compose.yml ファイルの同期

パイプラインは、コードリポジトリからターゲットホストへ docker-compose.yml ファイルを自動的に転送しません。以下のいずれかの方法を使用して、ターゲットホストでファイルを利用できるようにします：

• ビルドステージ中に docker-compose.yml ファイルをビルドアーティファクトにパッケージ化します。ファイルはデプロイ中にアーティファクトと共にホストにダウンロードされます。

• デプロイスクリプトで scp、wget、または git clone を使用してファイルを転送します。

デプロイスクリプトの例：

cd /home/admin/app
tar zxvf package.tgz
docker-compose up -d

Python またはその他のコードベースプロジェクトのデプロイ

Python や同様のプロジェクトの場合、ビルドステージ中にコードをアーティファクトリポジトリにアップロードし、デプロイ中にダウンロードして展開します。または、デプロイスクリプトで Git からコードをプルします。

デプロイ詳細の表示

デプロイジョブを設定した後、パイプラインを実行します。デプロイ中に、[deployment details] をクリックしてステータスを表示します。パイプライン実行詳細ページで [VM Deploy] ジョブを見つけ、[deployment details] をクリックして詳細ページを開きます。

デプロイのロールバック

パイプラインの [Deployment History] で、ロールバックするデプロイを見つけ、[Roll Back] をクリックします。

ロールバックは、過去のアーティファクトとデプロイスクリプトを使用してデプロイを再実行します。これは、単純な状態の復元ではなく、以前のバージョンで新しいデプロイを実行することと同じです。過去のアーティファクトが利用できない場合、ロールバックはできません。

デプロイ失敗のトラブルシューティング

デプロイ成功後にアプリケーションが実行されない

パイプラインがデプロイ成功を示しているにもかかわらず、アプリケーションがホスト上で実行されていない場合、最も可能性の高い原因はデプロイスクリプトに起動コマンドがないことです。ホストデプロイはアーティファクトを転送し、デプロイスクリプトを実行するだけです。アプリケーションを自動的に起動することはありません。デプロイスクリプトに、アーティファクトを展開してアプリケーションプロセスを起動するコマンドが含まれていることを確認してください。例：

tar zxvf /home/admin/app/package.tgz -C /home/admin/application/
sh /home/admin/application/deploy.sh restart

デプロイ中の SLB トラフィックの管理

デプロイ中に Server Load Balancer (SLB) のトラフィックを削除および復元するには、デプロイスクリプトにトラフィック管理コマンドを追加します。ベストプラクティス：

1. 単一のホストを含むホストグループを作成します。

2. デプロイスクリプト内で、SLB からホストを削除し、アプリケーションをデプロイし、デプロイを検証し、ホストを SLB に復元する、というステップを順番に追加します。

3. すべてのステップを同じホストグループで実行することで、トラフィックの削除と復元が異なるホストを対象とする場合に発生する不整合を防ぎます。