Azure DevOps 接続 - AWS CodePipeline

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

Azure DevOps 接続

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

注記

アカウントで既存の接続を作成または使用する代わりに、別の 間で共有接続を使用できます AWS アカウント。「別のアカウントと共有されている接続を使用する」を参照してください。

注記

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

CodePipeline に Azure DevOps ソースアクションを追加するには、次のいずれかを選択できます。

注記

[設定] からデベロッパーツール コンソールを使用して、接続を作成することもできます。[接続を作成する] を参照してください。

開始する前に:

  • Azure DevOps などのサードパーティーリポジトリのプロバイダーでアカウントを作成している必要があります

  • Azure DevOps リポジトリなどのサードパーティーのコードリポジトリを既に作成している必要があります。

注記

Azure DevOps 接続は、接続の作成に使用された Azure DevOps アカウントが所有するリポジトリへのアクセスのみを提供します。

接続をインストールするには、Azure アカウントの管理者権限が必要です。

Azure DevOps への接続を作成する (コンソール)

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

ステップ1:パイプラインを作成または修正するには

パイプラインを作成または修正するには
  1. CodePipeline コンソールにサインインします。

  2. 次のいずれかを選択します 。

    • パイプラインの作成を選択します。[パイプラインを作成する] の手順に従い最初の画面を完了し、[] を選択します。ソースページのソースプロバイダーで、Azure DevOps を選択します。

    • 既存のパイプラインを編集することを選択します。[Edit]、[Edit Stage] の順に選択します。ソースアクションを追加または編集するかを選択します。[アクションの編集] ページで、[Action name (アクション名)] に自分のアクション名を入力します。アクションプロバイダーで、Azure DevOps を選択します。

  3. 次のいずれかを行います:

    • Connection で、プロバイダーへの接続をまだ作成していない場合は、Connect to Azure DevOps を選択します。ステップ 2: Azure DevOps への接続を作成するに進みます。

    • [接続] でプロバイダへの接続を既に作成している場合は、その接続を選択します。ステップ 3: 接続のソースアクションを保存するに進みます。

ステップ 2: Azure DevOps への接続を作成する

Azure DevOps への接続を作成するには
  1. Azure DevOps リポジトリへの接続を作成するには、「プロバイダーの選択」で「Azure DevOps」を選択します。[接続名] に、作成する接続の名前を入力します。    Azure DevOps に接続を選択し、ステップ 2 に進みます。

    Azure DevOps 用に選択された接続オプションを示すコンソールのスクリーンショット。
  2. Azure DevOps への接続設定ページで、接続名が表示されます。

    Azure DevOps アプリで、アプリのインストールを選択するか、新しいアプリのインストールを選択して作成します。

    注記

    アプリは、Azure DevOps アカウントごとに 1 回だけインストールします。コネクタアプリを既にインストールしている場合は、それを選択し、このセクションの最後のステップに進みます。

  3. Microsoft のログインページが表示された場合は、認証情報を使用してログインし、続行することを選択します。

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

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

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

ステップ 3: Azure DevOps ソースアクションを保存する

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

接続でソースアクションを完了して保存するには
  1. [リポジトリ名] で、サードパーティーのリポジトリの名前を選択します。

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

  3. [Output artifact format (出力アーティファクトのフォーマット)] で、アーティファクトのフォーマットを選択する必要があります。

    • デフォルトの メソッドを使用して Azure DevOps アクションからの出力アーティファクトを保存するには、CodePipeline のデフォルトを選択します。アクションは、リポジトリからファイルにアクセスして、パイプラインアーティファクトストアの ZIP ファイルにアーティファクトを保存します。

    • リポジトリへの URL 参照を含む JSON ファイルを保存して、ダウンストリームのアクションで Git コマンドを直接実行できるようにするには、[Full clone (フルクローン)] を選択します。このオプションは、CodeBuild ダウンストリームアクションでのみ使用できます。

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

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

Azure DevOps への接続を作成する (CLI)

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

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

重要

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

接続を作成するには
  1. ターミナル (Linux/macOS/Unix) またはコマンドプロンプト (Windows) を開きます。 AWS CLI を使用して create-connection コマンドを実行し、接続--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" }
  2. コンソールを使用して接続を完了します。詳細については、「Update a pending connection」を参照してください。

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

    • 手動リリースでのみ開始するようにパイプラインのトリガー設定を構成するには、設定に以下の行を追加します。

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

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