演習 - Azure リソースをプロビジョニングする

Terraform を使用して GitHub Actions ワークフローを設定する

GitHub ワークフローでお使いの Azure アカウントにアクセスできるようにしましょう。

Azure CLI で次のコマンドを実行して、サービス プリンシパルを作成します。

az ad sp create-for-rbac --name "<yourServicePrincipalName>" --role contributor --scopes /subscriptions/<subscriptionId> --sdk-auth

上記のコマンドを実行すると、次の JSON が返されます。 次の手順で使用するためにコピーしてください。

{
  "clientId": "XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXXX",
  "clientSecret": "XXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
  "subscriptionId": "XXXXXXXXX-XXXXX-XXXX-XXXX-XXXXXXXXXXXXX",
  "tenantId": "XXXXXXXX-XXXXX-XXXX-XXXX-XXXXXXXXXXX",
  ...
}

GitHub シークレット

GitHub リポジトリにはシークレットと呼ばれる機能があり、Terraform による Azure への認証に使用される機密情報を格納できます。

前の手順で必要な ID とシークレットを作成したら、このユニットの次の手順は、それらを GitHub プロジェクトのシークレット ストアに追加することです。

この演習では、次のシークレットを格納する必要があります。

• AZURE_CLIENT_ID
• AZURE_CLIENT_SECRET
• AZURE_SUBSCRIPTION_ID
• AZURE_TENANT_ID

シークレットを格納するには、フォークした GitHub リポジトリに移動し 、[設定] を選択し、[ シークレットと変数] を選択してから、左側のウィンドウで [アクション] を選択します。

サービス プリンシパルの作成時に返された値を使用して、4 つのシークレットを作成します。

次のスクリーンショットに示すように、必ず引用符 (" ") を付けずにシークレットを格納してください。

ワークフロー ファイル

プロジェクト ディレクトリ内には .github/workflows という名前のディレクトリがあり、その中には main.yml という名前のファイルがあります。

main.yml ファイルは GitHub ワークフローです。 構成したシークレットを使用して、ご自分の Azure サブスクリプションにアプリケーションがデプロイされます。

main.yml ワークフロー ファイルには、次の内容があります。

name: TERRAFORM

on:
  push:
    branches: [ main ]
    paths:
    - 'terraform/**'
  pull_request:
    branches: [ main ]
    paths:
    - 'terraform/**'

  workflow_dispatch:
jobs:
  terraform:
    runs-on: ubuntu-latest

    env:
      ARM_CLIENT_ID: ${{ secrets.AZURE_CLIENT_ID }}
      ARM_CLIENT_SECRET: ${{secrets.AZURE_CLIENT_SECRET}}
      ARM_SUBSCRIPTION_ID: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
      ARM_TENANT_ID: ${{ secrets.AZURE_TENANT_ID }}

    defaults:
      run:
        working-directory: ./terraform
    steps:
      - uses: actions/checkout@v2

      - name: Setup Terraform
        uses: hashicorp/setup-terraform@v1

      - name: Terraform Init
        run: terraform init

      - name: Terraform Plan
        run: terraform plan

      - name: Terraform Apply
        run: terraform apply -auto-approve

このワークフローにより、次の操作が実行されます。

• 構成が正しい形式になっているかどうかが確認されます。
• すべての pull request に対してプランが生成されます。
• terraform ディレクトリ内のファイルを更新すると、構成がトリガーされます。

ワークフローをトリガーする

次に、リポジトリで、以下のようにして GitHub アクションをトリガーします。

1. 組み込みの GitHub テキスト エディターまたは任意のエディターで、 terraform/variables.tf を次のように編集します。

   a. "CHANGE_ME_RESOURCE_GROUP" を目的のリソース グループ名に変更します。
   b。 "CHANGE_ME_APP_NAME" を目的のアプリケーション名に変更します。 アプリケーション名は一意になるようにします。

   variable "resource_group" {
     description = "The resource group"
     default = "CHANGE_ME_RESOURCE_GROUP"
   }
   
   variable "application_name" {
     description = "The Spring Boot application name"
     default     = "CHANGE_ME_APP_NAME"
   }
   
   variable "___location" {
     description = "The Azure ___location where all resources in this example should be created"
     default     = "westeurope"
   }
   

2. 変更をコミットします。

GitHub Actions のビルドを確認する

1. リポジトリで [ アクション] を選択し、左側のウィンドウで TERRAFORM ワークフローを選択します。

2. 手順の一覧で、Terraform Init、Terraform Plan、Terraform Validate がトリガーされたことを確認します。

   

3. 手順の一覧で Terraform Apply を展開し、次のことを確認します。

• Terraform によってリソースが作成され、Azure インスタンスの URL が表示されている。

• Azure アプリ インスタンスが一般公開されている。

  

次のステップ

次の演習では、GitHub Actions を使用してサンプルの Spring Boot アプリケーションをデプロイします。

アプリケーション名と Azure リソース グループを設定する

GitHub リポジトリで、次のアクションを実行して Azure リソース名を編集します。

1. 組み込みの GitHub テキスト エディターまたは任意のエディターで、 terraform/variables.tf を次のように編集します。

   a. "<CHANGE_ME_RESOURCE_GROUP>" を目的のリソース グループ名に変更します。
   b。 "<CHANGE_ME_APP_NAME>" を目的のアプリケーション名に変更します。 アプリケーション名は一意になるようにします。

   variable "resource_group" {
     description = "The resource group"
     default = "<CHANGE_ME_RESOURCE_GROUP>"
   }
   
   variable "application_name" {
     description = "The Spring Boot application name"
     default     = "CHANGE_ME_APP_NAME"
   }
   
   variable "___location" {
     description = "The Azure ___location where all resources in this example should be created"
     default     = "westeurope"
   }
   

2. 変更をコミットする

Terraform リソースをプロビジョニングするための Azure パイプラインを作成する

Azure DevOps プロジェクトで、プロビジョニングと、ビルドおよびデプロイ用に 2 つの異なるパイプラインを作成します。 プロビジョニング パイプラインにより、後でビルドおよびデプロイのパイプラインを介してリリースされる Azure リソースが作成されます。

最初のプロビジョニング パイプラインを作成しましょう。

1. 組織を選択し、[ 新しいプロジェクト] を選択します。

2. 次のパラメーターを指定します。

   パラメーター	説明
   プロジェクト名	必須
   説明	省略可能
   視程	[プライベート] を選択する
   上級
   バージョン コントロール	GIT を選択 する
   作業項目プロセス	[基本] を選択する

3. [ プロジェクトの作成] を選択してプロジェクトを作成し、ウェルカム ページを開きます。

Azure パイプライン サービス接続を設定する

Azure パイプラインに Azure アカウントへのアクセスを許可しましょう。

1. Azure DevOps で、プロジェクト設定ページから [サービス接続 ] ページを開きます

2. [ サービス接続の作成 ] を選択し、[ Azure Resource Manager] を選択してから、[ 次へ] を選択します。

3. [ サービス プリンシパル (自動)] を選択し、[ 次へ] を選択します。

4. 次のパラメーターを指定します。

   パラメーター	説明
   スコープのレベル	Azure サブスクリプションを選択する
   サブスクリプション	既存の Azure サブスクリプションを選択します
   リソース グループ	空のままにして、サブスクリプション内で定義されているすべてのリソースにユーザーがアクセスできるようにします
   接続名	必須。 タスクのプロパティでこのサービス接続を参照するために使用する名前。 この名前は、ご自分の Azure サブスクリプションの名前ではありません。

5. [保存] を選択して接続を作成します。

プロビジョニング パイプラインを作成する

プロジェクトを設定して Azure に接続した後、Azure パイプラインを作成して terraform リソースをプロビジョニングする必要があります。

Azure DevOps でプロジェクトに移動し、左側のメニューで [ パイプライン ] を選択し、[パイプラインの 作成] を選択します。

1. [接続] タブで、[GitHub] (YAML ファイル) を選択します。
2. GitHub へのアクセスを承認するように求められた場合は、GitHub の資格情報を入力し、要求された特権で Azure Pipelines のアクセス権を承認します。
3. [選択] タブで、テンプレートを含む GitHub リポジトリを選択します。
4. [インベントリ] タブで [パイプラインの構成] を選択します。
5. [構成] タブで、"既存の Azure Pipelines YAML ファイル" を使用することを選択します。
6. パスで "/azuredevops/provision.yml" を選択します
7. [ 続行] を選択して [ 確認 ] タブに移動し、パイプラインを確認します。

[パイプライン YAML をレビューする] 画面で、パイプラインの作成に使用する Yaml ファイルを調べてみましょう。

name: Provision Resources

trigger: none

pool:
  vmImage: 'ubuntu-latest'

steps:

# Initialize the Terraform environment and bind to your Service Connection
- task: TerraformTaskV1@0
  inputs:
    provider: 'azurerm'
    command: 'init'
    workingDirectory: $(Build.Repository.LocalPath)/terraform
    backendServiceArm: $(serviceConnection)
    backendAzureRmResourceGroupName: $(serviceConnection)
    backendAzureRmStorageAccountName: $(serviceConnection)
    backendAzureRmContainerName: 'tfstate'
    backendAzureRmKey: 'tf/terraform.tfstate'

# Apply the Terraform config and deploy to Azure
- task: TerraformTaskV1@0
  inputs:
    provider: 'azurerm'
    command: 'apply'
    workingDirectory: $(Build.Repository.LocalPath)/terraform
    backendAzureRmContainerName: 'tfstate'
    backendAzureRmKey: 'tf/terraform.tfstate'
    environmentServiceNameAzureRM: $(serviceConnection)

構成で使用するフィールドをいくつか確認しましょう。

• serviceConnection: 以前に設定した Azure PipeLine サービス接続
• コマンド: Terraform ワークフロー コマンド: init または apply
• backendAzure: 共有状態を格納するためにチーム環境で必要な必須フィールド。\

パイプラインを保存して実行する前に、サービス接続にバインドする変数を追加する必要があります。

1. 変数 (右上) を選択し、サービス接続の名前として値を持つ "serviceConnection" という名前の変数を追加します。
2. [ OK] (右下隅) を選択して変数を保存します。

最後に、[実行] (右上隅) を選択してパイプラインを保存して実行します

パイプラインの実行を監視する

[ジョブ] の下で、ステップごとにビルド プロセスをトレースします。

パイプラインが実行されたら、Terraform の 1 番目の init ステージ、次に 2 番目の apply ステージが、青 (実行中) から緑 (完了) に移行するのを監視します。 ステージを選択して、パイプラインの動作を監視することができます。

次のステップ

次の演習では、Azure Pipelines を使用して、サンプルの Spring Boot アプリケーションをビルドしてデプロイします。