Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Les connexions vous permettent d'autoriser et d'établir des configurations qui associent votre fournisseur tiers à vos AWS ressources. Pour associer votre référentiel tiers en tant que source de votre pipeline, vous devez utiliser une connexion. 

**Note**  
Au lieu de créer ou d'utiliser une connexion existante dans votre compte, vous pouvez utiliser une connexion partagée entre un autre Compte AWS. Consultez [Utiliser une connexion partagée avec un autre compte](connections-shared.md).

**Note**  
Cette fonctionnalité n'est pas disponible dans les régions Asie-Pacifique (Hong Kong), Asie-Pacifique (Hyderabad), Asie-Pacifique (Jakarta), Asie-Pacifique (Melbourne), Asie-Pacifique (Osaka), Afrique (Le Cap), Moyen-Orient (Bahreïn), Moyen-Orient (Émirats arabes unis), Europe (Espagne), Europe (Zurich), Israël (Tel Aviv) ou (USA Ouest). AWS GovCloud Pour faire référence aux autres actions disponibles, voir[Intégrations de produits et de services avec CodePipeline](integrations.md). Pour les considérations relatives à cette action dans la région Europe (Milan), voir la note dans[CodeStarSourceConnection pour Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com et les actions GitLab autogérées](action-reference-CodestarConnectionSource.md).

Pour ajouter une action DevOps source Azure CodePipeline, vous pouvez choisir de : 
+ Utilisez l'assistant de **création de pipeline** ou la page **d'action Modifier** de la CodePipeline console pour choisir l'option du DevOps fournisseur **Azure**. [Création d'une connexion à Bitbucket Cloud (console)](connections-bitbucket.md#connections-bitbucket-console)Reportez-vous à la section pour ajouter l'action. La console vous permet de créer une ressource de connexions.
+ Utilisez la CLI pour ajouter la configuration de l'`CreateSourceConnection`action avec le `Azure DevOps` fournisseur comme suit :
  + Pour créer vos ressources de connexions, reportez-vous [Création d'une connexion à Azure DevOps (CLI)](#connections-azure-cli) à la section Création d'une ressource de connexions avec la CLI.
  + Utilisez l'`CreateSourceConnection`exemple de configuration d'action [CodeStarSourceConnection pour Bitbucket Cloud GitHub, GitHub Enterprise Server, GitLab .com et les actions GitLab autogérées](action-reference-CodestarConnectionSource.md) pour ajouter votre action comme indiqué dans[Création d'un pipeline (interface de ligne de commande)](pipelines-create.md#pipelines-create-cli).

**Note**  
Vous pouvez également créer une connexion à l'aide de la console Developer Tools sous **Paramètres**. Voir [Créer une connexion](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-create.html).

Avant de commencer :
+ Vous devez avoir créé un compte auprès du fournisseur du référentiel tiers, tel qu'Azure DevOps
+ Vous devez déjà avoir créé un référentiel de code tiers, tel qu'un DevOps référentiel Azure.

**Note**  
 DevOps Les connexions Azure fournissent uniquement l'accès aux référentiels détenus par le DevOps compte Azure qui a été utilisé pour créer la connexion.  
Pour installer la connexion, vous devez disposer des autorisations d'**administration** pour le compte Azure.

**Topics**
+ [Création d'une connexion à Azure DevOps (console)](#connections-azure-console)
+ [Création d'une connexion à Azure DevOps (CLI)](#connections-azure-cli)

## Création d'une connexion à Azure DevOps (console)
<a name="connections-azure-console"></a>

Suivez ces étapes pour utiliser la CodePipeline console afin d'ajouter une action de connexion pour votre DevOps référentiel Azure.

### Étape 1 : créer ou modifier votre pipeline
<a name="connections-azure-console-action"></a>

**Pour créer ou modifier votre pipeline**

1. Connectez-vous à la CodePipeline console.

1. Choisissez l’une des options suivantes.
   + Choisissez de créer un pipeline. Suivez les étapes décrites dans *Créer un pipeline* pour terminer le premier écran et choisissez **Next**. Sur la page **Source**, sous **Source Provider**, sélectionnez **Azure DevOps**.
   + Choisissez de modifier un pipeline existant. Choisissez **Modifier**, puis sélectionnez **Modifier l'étape**. Choisissez d'ajouter ou de modifier votre action source. Sur la page **Modifier l'action**, sous **Nom de l'action**, entrez le nom de votre action. Dans **Action provider**, choisissez **Azure DevOps**.

1. Effectuez l’une des actions suivantes :
   + Sous **Connexion**, si vous n'avez pas encore créé de connexion avec votre fournisseur, choisissez **Connect to Azure DevOps**. Passez à l'étape 2 : créer une connexion à Azure DevOps.
   + Sous **Connexion**, si vous avez déjà créé une connexion avec votre fournisseur, choisissez-la. Passez à l'étape 3 : Enregistrer l'action source pour votre connexion.

### Étape 2 : créer une connexion à Azure DevOps
<a name="connections-azure-console-create"></a>

**Pour créer une connexion à Azure DevOps**

1. Pour créer une connexion à un DevOps référentiel Azure, sous **Sélectionnez un fournisseur**, choisissez **Azure DevOps**. Dans **Connection name (Nom de la connexion)**, saisissez le nom de la connexion que vous souhaitez créer. Choisissez **Connect to Azure DevOps**, puis passez à l'étape 2.  
![\[Capture d'écran de la console montrant l'option de connexion sélectionnée pour Azure DevOps.\]](http://docs.aws.amazon.com/fr_fr/codepipeline/latest/userguide/images/create-connection-azure.png)

1. Sur la page des DevOps paramètres **Connect to Azure**, le nom de votre connexion s'affiche.

   Sous ** DevOps Applications Azure**, choisissez une installation d'application ou choisissez **Installer une nouvelle application** pour en créer une.
**Note**  
Vous n'installez l'application qu'une seule fois pour chaque DevOps compte Azure. Si vous avez déjà installé l'application Connector, choisissez-la et passez à la dernière étape de cette section.

1. Si la page de connexion de Microsoft s'affiche, connectez-vous avec vos informations d'identification, puis choisissez de continuer.

1. Sur la page d'installation de l'application, un message indique que l'application du connecteur essaie de se connecter à votre DevOps compte Azure. 

   Choisissez **Grant access (Accorder l’accès)**.

1. Sur la page de connexion, l'identifiant de connexion de votre nouvelle installation est affiché. Choisissez **Se connecter**. La connexion créée s'affiche dans la liste des connexions.

### Étape 3 : enregistrer votre action DevOps source Azure
<a name="connections-azure-console-save"></a>

Suivez ces étapes dans l'assistant ou sur la page **Modifier l'action** pour enregistrer votre action source avec vos informations de connexion.

**Pour terminer et enregistrer votre action source avec votre connexion**

1. Dans **Nom du référentiel**, choisissez le nom de votre référentiel tiers.

1. Sous **Déclencheurs du pipeline**, vous pouvez ajouter des déclencheurs si votre action est une anCodeConnections action. Pour configurer la configuration des déclencheurs du pipeline et pour éventuellement filtrer à l'aide de déclencheurs, reportez-vous à la section[Ajouter un déclencheur avec des types d'événements de type code push ou pull request](pipelines-filter.md).

1. Dans **Output artifact format (Format d'artefact de sortie)**, vous devez choisir le format de vos artefacts. 
   + Pour stocker les artefacts de sortie de l' DevOps action Azure à l'aide de la méthode par défaut, choisissez **CodePipeline default**. L'action accède aux fichiers depuis le référentiel et stocke les artefacts dans un fichier ZIP dans le magasin d'artefacts du pipeline.
   + Pour stocker un fichier JSON contenant une référence d'URL au référentiel afin que les actions en aval puissent exécuter directement les commandes Git, choisissez **Full clone (Clone complet)**. Cette option ne peut être utilisée que par des actions CodeBuild en aval.

     Si vous choisissez cette option, vous devrez mettre à jour les autorisations associées à votre rôle de service de CodeBuild projet, comme indiqué dans[Ajoutez CodeBuild GitClone des autorisations pour les connexions à Bitbucket GitHub, GitHub Enterprise Server ou .com GitLab](troubleshooting.md#codebuild-role-connections).

1. Choisissez **Suivant** dans l'assistant ou **Enregistrer** sur la page **d'action Modifier**.

## Création d'une connexion à Azure DevOps (CLI)
<a name="connections-azure-cli"></a>

Vous pouvez utiliser le AWS Command Line Interface (AWS CLI) pour créer une connexion. 

Pour ce faire, utilisez la commande **create-connection**. 

**Important**  
Une connexion créée via le AWS CLI ou AWS CloudFormation est en `PENDING` statut par défaut. Après avoir créé une connexion avec la CLI CloudFormation, utilisez la console pour modifier la connexion afin de définir son état`AVAILABLE`.

**Pour créer une connexion**

1. Ouvrez une invite de terminal (Linux, macOS ou Unix) ou de commande (Windows). Utilisez le AWS CLI pour exécuter la **create-connection** commande, en spécifiant le `--provider-type` et `--connection-name` pour votre connexion. Dans cet exemple, le nom du fournisseur tiers est `AzureDevOps` et le nom de connexion spécifié est `MyConnection`.

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

   En cas de succès, cette commande renvoie les informations ARN de connexion semblables à ce qui suit.

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

1. Utilisez la console pour terminer la connexion. Pour plus d'informations, voir [Mettre à jour une connexion en attente](https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-update.html).

1. Le pipeline détecte par défaut les modifications lors de l'envoi du code vers le référentiel des sources de connexion. Pour configurer la configuration du déclencheur du pipeline pour le lancement manuel ou pour les balises Git, effectuez l'une des opérations suivantes :
   + Pour configurer la configuration du déclencheur du pipeline afin qu'elle commence par un déverrouillage manuel uniquement, ajoutez la ligne suivante à la configuration : 

     ```
     "DetectChanges": "false",
     ```
   + Pour configurer la configuration des déclencheurs du pipeline afin de filtrer avec des déclencheurs, voir plus de détails dans[Ajouter un déclencheur avec des types d'événements de type code push ou pull request](pipelines-filter.md). Par exemple, ce qui suit ajoute des balises Git au niveau du pipeline de la définition JSON du pipeline. Dans cet exemple, `release-v0` et `release-v1` sont les balises Git à inclure et `release-v2` les balises Git à exclure.

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