Code Stream のアプリケーションをブルーグリーン展開に展開する方法

ブルーグリーンは、2 台の Docker ホストを使用して両者を同じように Kubernetes クラスタに展開および構成する展開モデルです。ブルーグリーン展開モデルで Code Stream のパイプラインがアプリケーションを展開するようにすると、ご使用の環境のダウンタイムを短縮できます。

展開モデルのブルーインスタンスとグリーンインスタンスは、それぞれ異なる目的を果たします。一度に 1 つのインスタンスのみが、アプリケーションを展開するライブトラフィックを受け入れます。各インスタンスは、一定の時刻にそのトラフィックを受け入れます。ブルーインスタンスはアプリケーションの最初のバージョンを受け取り、グリーンインスタンスは 2 番目のバージョンを受け取ります。

ブルーグリーン環境のロードバランサによって、アプリケーションを展開するときにライブトラフィックがどのルートをたどるかが決まります。ブルーグリーンモデルを使用すると、環境は動作し続け、ユーザーはダウンタイムがあっても気づかず、パイプラインはアプリケーションを本番環境に継続的に統合して展開します。

Code Stream でパイプラインを作成すると、ブルーグリーン展開モデルが 2 つのステージで表されます。開発用のステージと本番用のステージです。

Code Stream パイプラインワークスペースでは、継続的インテグレーションタスクとカスタムタスクで Docker と Kubernetes がサポートされます。

ワークスペースの構成については、パイプラインワークスペースの構成を参照してください。

表 1. ブルーグリーン展開の開発ステージタスク
タスクタイプ	タスク
Kubernetes	ブルーグリーン展開用の名前空間を作成します。
Kubernetes	Docker Hub のプライベートキーを作成します。
Kubernetes	アプリケーションの展開に使用するサービスを作成します。
Kubernetes	ブルー展開を作成します。
ポーリング	ブルー展開を確認します。
Kubernetes	名前空間を削除します。

表 2. ブルーグリーン展開用の本番ステージタスク
タスクタイプ	タスク
Kubernetes	グリーンは、ブルーからサービスの詳細を取得します。
Kubernetes	グリーンレプリカセットの詳細を取得します。
Kubernetes	グリーン展開を作成し、プライベートキーを使用してコンテナイメージをプルします。
Kubernetes	サービスを更新します。
ポーリング	本番 URL で展開が成功したことを確認します。
Kubernetes	ブルー展開を終了します。
Kubernetes	ブルー展開を削除します。

独自のブルーグリーン展開モデルにアプリケーションを展開するには、 Code Stream でパイプラインを作成して 2 つのステージを含めます。最初のステージにはブルーインスタンスにアプリケーションを展開するブルータスクを含め、2 番目のステージにはグリーンインスタンスにアプリケーションを展開するグリーンタスクを含めます。

パイプラインの作成には、CICD スマートパイプラインテンプレートを使用できます。自動的にパイプラインのステージとタスクを作成するもので、展開を選択できます。

パイプラインを手動で作成する場合は、パイプラインステージを計画する必要があります。例については、タスクの手動追加を行う前の Code Stream での CICD ネイティブビルドの計画を参照してください。

この例では、CICD スマートパイプラインテンプレートを使用してブルーグリーンパイプラインを作成します。

前提条件

AWS 上の動作中の Kubernetes クラスタにアクセスできることを確認します。
ブルーグリーン展開環境を設定し、ブルーインスタンスとグリーンインスタンスが同一になるように設定していることを確認します。
AWS 上の Kubernetes クラスタにアプリケーションイメージを展開する Code Stream の Kubernetes エンドポイントを作成します。
CICD スマートパイプラインテンプレートの使用について理解する必要があります。スマートパイプラインテンプレートを使用する前の Code Stream での CICD ネイティブビルドの計画を参照してください。

手順

[パイプライン] > [新しいパイプライン] > [スマートテンプレート] > [CI/CD テンプレート] の順にクリックします。
CICD スマートパイプラインテンプレートの CI 部分の情報を入力し、[次へ] をクリックします。
詳細については、スマートパイプラインテンプレートを使用する前の Code Stream での CICD ネイティブビルドの計画を参照してください。
スマートパイプラインテンプレートの CD 部分を入力します。
1. アプリケーション展開の環境を選択します。たとえば、[開発] と [本番] です。
2. パイプラインによる展開で使用するサービスを選択します。
3. [展開] 領域で、開発環境と本番環境のクラスタエンドポイントを選択します。
4. 本番展開モデルの場合、[ブルーグリーン] を選択し、[作成] をクリックします。

結果

完了です。スマートパイプラインテンプレートを使用して、AWS 上の Kubernetes 本番クラスタ内のブルーグリーンインスタンスにアプリケーションを展開するパイプラインを作成しました。

例: ブルーグリーン展開タスクのサンプルの YAML コード

ブルーグリーン展開の Kubernetes パイプラインタスクに表示される YAML コードは、名前空間、サービス、展開を作成する次の例のようになります。プライベート所有のリポジトリからイメージをダウンロードする必要がある場合は、Docker 構成の [シークレット] を含むセクションを YAML ファイルに含める必要があります。スマートパイプラインテンプレートを使用する前の Code Stream での CICD ネイティブビルドの計画の CD 部分を参照してください。

スマートパイプラインテンプレートによってパイプラインが作成されたら、それぞれの展開での必要に応じてタスクを変更できます。

サンプルの名前空間を作成する YAML コード：

apiVersion: v1
kind: Namespace
metadata:
  name: codestream-82855
  namespace: codestream-82855

サンプルのサービスを作成する YAML コード：

apiVersion: v1
kind: Service
metadata:
  labels:
    app: codestream-demo
  name: codestream-demo
  namespace: bluegreen-799584
spec:
  minReadySeconds: 0
  ports:
  - port: 80
  selector:
    app: codestream-demo
    tier: frontend
  type: LoadBalancer

サンプルの展開を作成する YAML コード：

apiVersion: extensions/v1
kind: Deployment
metadata:
  labels:
    app: codestream-demo
  name: codestream-demo
  namespace: bluegreen-799584
spec:
  minReadySeconds: 0
  replicas: 1
  selector:
    matchLabels:
      app: codestream-demo
      tier: frontend
  template:
    metadata:
      labels:
        app: codestream-demo
        tier: frontend
    spec:
      containers:
      - image: ${input.image}:${input.tag}
        name: codestream-demo
        ports:
        - containerPort: 80
          name: codestream-demo
      imagePullSecrets:
      - name: jfrog-2
      minReadySeconds: 0

次のタスク

Code Stream の使用方法の詳細については、Code Stream を使用するためのチュートリアルを参照してください。

デプロイをロールバックする場合は、Code Stream で展開をロールバックする方法を参照してください。

この他の参考情報については、Code Stream 管理者および開発者向けのその他のリソースを参照してください。