1.1.3.2. Azure DevOpsをセットアップする¶
注釈
- 本ページに記載の画像・設定項目は、2022年5月時点の情報です。Microsoft Azureの仕様変更により、内容が変更となる場合がありますのでご注意ください。
Azure DevOpsにおいて、自動構築コード実行に必要な申請、タスク追加およびGitHub連携など、自動構築に必要な初期設定の手順です。
Azure Pipelinesコード利用申請¶
不正利用防止のため、Azure DevOpsの利用開始後はAzure Pipelinesコード(自動構築コード)の実行に制限がかかっています。
その制限を解除するための申請手順は以下のとおりです。自動構築コード実行前に申請をお願いします。
なお、申請結果受領までは2～3営業日かかりますのでご注意ください。
「Azure DevOps Parallelism Request」にアクセスします。
入力フォームに以下のとおり必要事項を入力し、「送信」をクリックします。
- What is your name?: <担当者の氏名>
- What is your email address?: <担当者のメールアドレス>
- What is the name of your Azure DevOps Organization?: <作成した組織名>
- Are you requesting a parallelism increase for Public or Private projects?: Private
「ありがとうございます。回答が送信されました。」と表示されることを確認します。
2～3営業日で、「担当者のメールアドレス」宛に審査結果が届きます。承認されると、自動構築コードの実行が可能となります。
- 承認メール
- 件名: Free tier request was completed
- 差出人: ▲▲▲@microsoft.com
Pipelinesコード実行用サービスプリンシパル作成¶
注釈
- 本項の内容は、以下の環境構成において実施する手順です。
- 構成C: Azure IoT Hub・温湿度センサー利用
作成したAzure DevOpsに割り当てるサービスプリンシパル(Azure環境の実行権限)を作成します。
「Azure Portal」にアクセスし、Azureロール「所有者」または「ユーザ アクセス管理者」を持つユーザーでログインします。
画面上部の検索窓にて「Azure Active Directory」と入力し、検索結果より「Azure Active Directory」をクリックします。
画面左のメニューより、「アプリの登録」をクリックします。
「新規登録」をクリックします。
画面に沿って必要事項を以下のとおり入力し、「登録」をクリックします。
- 名前: <任意のサービスプリンシパル名>
- サポートされているアカウントの種類: この組織ディレクトリのみに含まれるアカウント
作成が完了し、作成したサービスプリンシパルの詳細画面が表示されることを確認します。
画面左のメニューより、「管理」>「証明書とシークレット」をクリックします。
「クライアント シークレット」タブを選択し、「+ 新しいクライアント シークレット」をクリックします。
表示された「クライアント シークレットの追加」画面にて、以下のとおり入力・選択し、「追加」をクリックします。
- 説明: <クライアントシークレットの説明文を任意で入力>
- 有効期限: <選択肢より選択>
クライアントシークレットが正しく作成されたことを確認し、「値」の文字列を控えておきます。
警告
- 「値」は新規作成時にのみ確認可能ですので、必ずこの画面で控えておくようにお願いします。
Azure Portal画面上部の検索窓にて、「サブスクリプション」と入力し、検索結果より「サブスクリプション」をクリックします。
表示されたサブスクリプション一覧より、使用するサブスクリプションをクリックします。
画面左のメニューより、「アクセス制御(IAM)」をクリックし、「ロールの割り当て」をクリックします。
「+ 追加」>「ロールの割り当ての追加」をクリックします。
「ロールの割り当ての追加」画面に表示された「ロール」リストより、「共同作成者」を選択し、「次へ」をクリックします。
「メンバー」タブをクリックし、以下のとおり表示・選択されていることを確認し、「+ メンバーを選択する」をクリックします。
- 選択されたロール: 共同作成者
- アクセスの割り当て先: ユーザ、グループ、またはサービス プリンシパル
「+ メンバーを選択する」をクリックし、上で作成したサービスプリンシパルを検索して選択し、「選択」をクリックします。
「メンバー」タブにて、以下のとおり表示・選択されていることを確認し、「レビューと割り当て」をクリックします。
- 選択されたロール: 共同作成者
- アクセスの割り当て先: ユーザ、グループ、またはサービス プリンシパル
- メンバー: <上で作成したサービスプリンシパル>
- Description: <任意>
「レビューと割り当て」タブをクリックし、表示された内容を確認し、「レビューと割り当て」ボタンをクリックします。
「ロールの割り当てが追加されました」と表示されることを確認します。
Azureへの接続¶
注釈
- 本項の内容は、以下の環境構成において実施する手順です。
- 構成C: Azure IoT Hub・温湿度センサー利用
上記手順で作成したサービスプリンシパルをAzure DevOpsに登録し、Azureへの接続を設定します。
サービスプリンシパルの作成および本手順を実施することで、Azure環境の自動構築が可能となります。
作成したAzure DevOpsのプロジェクトページにアクセスします。
- URL: https://dev.azure.com/<組織名>/<プロジェクト名>
画面左下の「Project settings」をクリックします。
画面左のメニューより「Pipelines」>「Service connections」をクリックします。
表示された「Service connections」画面の「Create service connection」をクリックします。
「Choose a service or connection type」画面にて「Azure Resource Manager」を選択し、「Next」をクリックします。
「Authentication method」画面にて「Service principal(manual)」を選択し、「Next」をクリックします。
Service connectionの作成画面にて、以下のとおり入力・選択し、「Verify」をクリックします。
- Environment: Azure Cloud
- Scope Level: Subscription
- Subscription Id: <サービスプリンシパルを作成したAzure環境のサブスクリプションID>
- Subscription Name: <サービスプリンシパルを作成したAzure環境のサブスクリプション名>
- Service Principal Id: <作成したサービスプリンシパルのアプリケーション(クライアント)ID>
- Credential: Service Principal Key
- Service principal Key: <作成したサービスプリンシパルのサービスプリンシパルキー>
- Tenant ID: <作成したサービスプリンシパルのディレクトリ(テナント)ID>
「Verify」ボタンの横に「Verification Succeeded」と表示されることを確認します。
残りの項目を以下のとおり入力・選択し、「Verify and save」をクリックします。
- Service connection name: <任意のサービス接続名>
- Description(optional): <説明文を任意で入力>
- Grant access permission to all pipelines: Off
Service connectionが正しく作成されることを確認します。
Azure DevOpsへのタスク追加¶
本環境の自動構築に必要なタスクを追加します。
タスク「Azure Pipelines Terraform Tasks」の追加¶
以下のURLにアクセスし、「Get it free」をクリックします。
Microsoftのログイン画面が表示された場合は、Azure DevOpsのユーザーでログインします。
「Select an Azure DevOps organization」画面にて、作成した組織を選択し「Install」をクリックします。
「You are all set!」と表示されることを確認します。
Azure DevOpsとGitHubの連携¶
本環境の自動構築に必要なコードを保存・管理するGitHubとAzure DevOpsを連携する手順です。
作成したAzure DevOpsのプロジェクトページにアクセスします。
- URL: https://dev.azure.com/<組織名>/<プロジェクト名>
画面左下の「Project settings」をクリックします。
画面左のメニューより「Pipelines」>「Service connections」をクリックします。
表示された「Service connections」画面右上の「New service connection」をクリックします。
「New service connection」画面にて「GitHub」を選択し、「Next」をクリックします。
「New GitHub service connection」画面にて以下のとおり入力・選択し、「Authorize」をクリックします。
- Authentication method: Grant authorization
- OAuth Configuration: Azure Pipelines
GitHubへのサインイン画面が表示されるので、ユーザー情報を入力しGitHubにサインインします。
「New GitHub service connection」画面にて、残りの空欄を以下のとおり入力・選択し、「Save」をクリックします。
- Service connection name: <任意のサービス接続名>
- Description(optional): <説明を任意で入力>
- Grant access permission to all repositories: Off
「Service connections」画面に、作成したサービス接続が表示されていることを確認します。