翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Azure DevOps 接続
<a name="connections-azure"></a>

接続を使用すると、サードパーティープロバイダーを AWS リソースに関連付ける設定を承認して確立できます。サードパーティーのリポジトリをパイプラインのソースとして関連付けるには、接続を使用します。

**注記**  
アカウントで既存の接続を作成または使用する代わりに、別の AWS アカウント間の共有接続を使用できます。「[別のアカウントと共有されている接続を使用する](connections-shared.md)」を参照してください。

**注記**  
この機能は、アジアパシフィック (香港）、アジアパシフィック (ハイデラバード）、アジアパシフィック (ジャカルタ）、アジアパシフィック (メルボルン）、アジアパシフィック (大阪）、アフリカ (ケープタウン）、中東 (バーレーン）、中東 (アラブ首長国連邦）、欧州 (スペイン）、欧州 (チューリッヒ）、イスラエル (テルアビブ）、または AWS GovCloud (米国西部) の各リージョンでは使用できません。利用可能なその他のアクションについては、「[CodePipeline との製品とサービスの統合](integrations.md)」を参照してください。欧州 (ミラノ) リージョンでのこのアクションに関する考慮事項については、「[CodeStarSourceConnection (Bitbucket Cloud、GitHub、GitHub Enterprise Server、GitLab.com、および GitLab セルフマネージドアクションの場合)](action-reference-CodestarConnectionSource.md)」の注意を参照してください。

CodePipeline で Azure DevOps のソースアクションを追加するには、次のいずれかを選択します。
+ CodePipeline コンソールの **[パイプラインの作成]** ウィザード、または **[アクションを編集する]** ページを使用して、**[Azure DevOps]** プロバイダーオプションを選択します。アクションを追加するには [Bitbucket Cloud への接続を作成する (コンソール)](connections-bitbucket.md#connections-bitbucket-console) を参照してください。このコンソールは、接続リソースの作成に役立ちます。
+ CLI を使用して、次の通りに `CreateSourceConnection` でのアクションのアクション設定を `Azure DevOps` プロバイダに追加します。
  + 接続リソースを作成するには、[Azure DevOps への接続を作成する (CLI)](#connections-azure-cli) を参照してCLI で接続リソースを作成します。
  + `CreateSourceConnection` でのアクション設定の例を [CodeStarSourceConnection (Bitbucket Cloud、GitHub、GitHub Enterprise Server、GitLab.com、および GitLab セルフマネージドアクションの場合)](action-reference-CodestarConnectionSource.md) で使用し、[パイプラインを作成する (CLI)](pipelines-create.md#pipelines-create-cli) で表示されるようにアクションを追加します。

**注記**  
[**設定**] からデベロッパーツール コンソールを使用して、接続を作成することもできます。[[接続を作成する](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html)] を参照してください。

開始する前に:
+ Azure DevOps など、サードパーティーのリポジトリプロバイダでアカウントを作成しておく必要があります。
+ Azure DevOps リポジトリなどのサードパーティーのコードリポジトリを既に作成しておく必要があります。

**注記**  
Azure DevOps 接続は、接続の作成に使用された Azure DevOps アカウントで所有するリポジトリへのアクセスだけを提供します。  
接続を作成するには、Azure アカウントの**管理者**アクセス許可が必要です。

**Topics**
+ [

## Azure DevOps への接続を作成する (コンソール)
](#connections-azure-console)
+ [

## Azure DevOps への接続を作成する (CLI)
](#connections-azure-cli)

## Azure DevOps への接続を作成する (コンソール)
<a name="connections-azure-console"></a>

次の手順を使用して、CodePipeline コンソールを使用して Azure DevOps リポジトリに接続アクションを追加します。

### ステップ１：パイプラインを作成または修正するには
<a name="connections-azure-console-action"></a>

**パイプラインを作成または修正するには**

1. CodePipeline コンソールにサインインします。

1.  次のいずれかを選択します 。
   + パイプラインの作成を選択します。[*パイプラインを作成する*] の手順に従い最初の画面を完了し、[**次**] を選択します。**[ソース]** ページの **[ソースプロバイダー]** で、**[Azure DevOps]** を選択します。
   + 既存のパイプラインを編集することを選択します。[**Edit**]、[**Edit Stage**] の順に選択します。ソースアクションを追加または編集するかを選択します。**[アクションを編集する]** ページで、**[アクション名]** に自分のアクション名を入力します。**[アクションプロバイダー]** で、**[Azure DevOps]** を選択します。

1. 次のいずれかを行います。
   + プロバイダーへの接続をまだ作成していない場合は、**[接続]**で **[Azure DevOps に接続]** を選択します。「ステップ 2: Azure DevOps への接続を作成する」に進みます。
   + [**接続**] でプロバイダへの接続を既に作成している場合は、その接続を選択します。ステップ 3： 接続のソースアクションを保存するに進みます。

### ステップ 2: Azure DevOps への接続を作成する
<a name="connections-azure-console-create"></a>

**Azure DevOps への接続を作成するには**

1. Azure DevOps リポジトリへの接続を作成するには、**[プロバイダーを選択する]** で、**[Azure DevOps]** を選択します。[**接続名**] に、作成する接続の名前を入力します。　　　 **[Azure DevOps に接続]** を選択して、ステップ 2 に進みます。  
![\[Azure DevOps 用に選択された接続オプションを示すコンソールのスクリーンショット。\]](http://docs.aws.amazon.com/ja_jp/codepipeline/latest/userguide/images/create-connection-azure.png)

1. **[Azure DevOps に接続]** 設定ページに、接続名が表示されます。

   **[Azure DevOps アプリ]** で、アプリケーションのインストールを選択するか、**[新しいアプリをインストールする]** を選択してアプリケーションを作成します。
**注記**  
アプリは、Azure DevOps アカウントごとに 1 回だけインストールします。コネクタアプリを既にインストールしている場合は、それを選択してこのセクションの最後のステップに移動します。

1. Microsoft のログインページが表示されたら、認証情報を使用してログインし、続行を選択します。

1. アプリのインストールページで、コネクタアプリが Azure DevOps アカウントに接続しようとしていることを示すメッセージが表示されます。

   **[アクセス権の付与]** を選択します。

1. 接続ページで、新規インストールの接続 ID が表示されます。**接続** を選択します。作成された接続が接続リストに表示されます。

### ステップ 3: Azure DevOps ソースアクションを保存する
<a name="connections-azure-console-save"></a>

ウィザードで次の手順を使用するか、[**アクションを編集**] ページで、ソースアクションを接続情報とともに保存します。

**接続でソースアクションを完了して保存するには**

1. [**リポジトリ名**] で、サードパーティーのリポジトリの名前を選択します。

1. **[パイプライントリガー]** で、アクションが CodeConnections アクションである場合は、トリガーを追加できます。パイプライントリガー設定を構成し、必要に応じてトリガーでフィルタリングするには、「[コードプッシュまたはプルリクエストイベントタイプを使用してトリガーを追加する](pipelines-filter.md)」で詳細を参照してください。

1. [**Output artifact format (出力アーティファクトのフォーマット)**] で、アーティファクトのフォーマットを選択する必要があります。
   + デフォルトのメソッドを使用して Azure DevOps アクションからの出力アーティファクトを保存するには、**[CodePipeline のデフォルト]** を選択します。アクションは、リポジトリからファイルにアクセスして、パイプラインアーティファクトストアの ZIP ファイルにアーティファクトを保存します。
   + リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[**Full clone (フルクローン)**] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。

      このオプションを選択した場合は、[Bitbucket、GitHub、GitHub Enterprise Server、または GitLab.com に接続するための CodeBuild GitClone アクセス許可を追加します。](troubleshooting.md#codebuild-role-connections) で示されるように CodeBuild プロジェクトサービスロールの権限を更新する必要があります。

1. ウィザード上で [**次へ**] または [**保存**] を [**アクションを編集**] ページで選択します。

## Azure DevOps への接続を作成する (CLI)
<a name="connections-azure-cli"></a>

 AWS Command Line Interface (AWS CLI) を使用して接続を作成できます。

これを行うには、**create-connection** コマンドを使用します。

**重要**  
 AWS CLI または を通じて作成された接続 AWS CloudFormation は、デフォルトで `PENDING`ステータスです。CLI または との接続を作成したら CloudFormation、コンソールを使用して接続を編集し、ステータスを にします`AVAILABLE`。

**接続を作成するには**

1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。を使用して **create-connection** コマンド AWS CLI を実行し、接続`--connection-name`の `--provider-type`と を指定します。この例では、サードパーティープロバイダー名は `AzureDevOps` で、指定された接続名は `MyConnection` です。

   ```
   aws codeconnections create-connection --provider-type AzureDevOps --connection-name MyConnection
   ```

   成功した場合、このコマンドは次のような接続 ARN 情報を返します。

   ```
   {
       "ConnectionArn": "arn:aws:codeconnections:us-west-2:account_id:connection/aEXAMPLE-8aad-4d5d-8878-dfcab0bc441f"
   }
   ```

1. コンソールを使用して接続を完了します。詳細については、「[Update a pending connection](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html)」を参照してください。

1. パイプラインはデフォルトで、接続ソースリポジトリへのコードのプッシュ時に変更を検出するようになっています。パイプライントリガーを手動リリース用または Git タグ用に設定するには、以下のいずれかを行います。
   + 手動リリースでのみ開始するようにパイプラインのトリガー設定を構成するには、設定に以下の行を追加します。

     ```
     "DetectChanges": "false",
     ```
   + トリガーでフィルタリングするようにパイプライントリガー設定を構成する方法の詳細については、「[コードプッシュまたはプルリクエストイベントタイプを使用してトリガーを追加する](pipelines-filter.md)」を参照してください。例えば、以下では、パイプライン JSON 定義のパイプラインレベルに Git タグを追加します。この例では、`release-v0` と `release-v1` が包含する Git タグで、`release-v2` が除外する Git タグです。

     ```
     "triggers": [
                 {
                     "providerType": "CodeStarSourceConnection",
                     "gitConfiguration": {
                         "sourceActionName": "Source",
                         "push": [
                             {
                                 "tags": {
                                     "includes": [
                                         "release-v0", "release-v1"
                                     ],
                                     "excludes": [
                                         "release-v2"
                                     ]
                                 }
                             }
                         ]
                     }
                 }
             ]
     ```