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.

# Installation AWS ParallelCluster
<a name="install"></a>

AWS ParallelCluster est distribué sous forme de package Python et est installé à l'aide `pip` du gestionnaire de packages Python. Pour plus d'informations sur l'installation de packages Python, consultez la section [Installation de packages](https://packaging.python.org/tutorials/installing-packages/) dans le *Guide de l'utilisateur des packages Python*.

**Modes d'installation AWS ParallelCluster :**
+ [Utilisation d'un environnement virtuel (recommandé)](#install-tool-venv)
+ [Utilisation de `pip`](#install-tool-pip)

Vous trouverez le numéro de version de la CLI la plus récente sur la [page des versions sur GitHub](https://github.com/aws/aws-parallelcluster/releases).

Dans ce guide, les exemples de commande supposent que vous avez installé Python v3. Les exemples de commande `pip` utilisent la version `pip3`.

## Installation AWS ParallelCluster dans un environnement virtuel (recommandé)
<a name="install-tool-venv"></a>

Nous vous recommandons d'effectuer l'installation AWS ParallelCluster dans un environnement virtuel. Si vous rencontrez des problèmes lorsque vous tentez d'effectuer une installation AWS ParallelCluster avec`pip3`, vous pouvez l'[installer AWS ParallelCluster dans un environnement virtuel](install-virtualenv.md) afin d'isoler l'outil et ses dépendances. Vous pouvez également utiliser une version différente de Python que celle que vous utilisez normalement.

## Installation AWS ParallelCluster dans un environnement non virtuel à l'aide de pip
<a name="install-tool-pip"></a>

La principale méthode de distribution pour AWS ParallelCluster Linux, Windows et macOS est `pip` un gestionnaire de packages pour Python. Il fournit un moyen d'installer, de mettre à niveau et de supprimer des packages Python et leurs dépendances.

**AWS ParallelCluster Version actuelle**  
AWS ParallelCluster est régulièrement mis à jour. Pour savoir si vous disposez de la dernière version, consultez la [page des versions sur GitHub](https://github.com/aws/aws-parallelcluster/releases).

Si vous possédez `pip` déjà une version compatible de Python, vous pouvez l'installer à AWS ParallelCluster l'aide de la commande suivante. Si vous avez Python version 3\$1 installé, nous vous recommandons d'utiliser la commande **pip3**.

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

## Étapes à suivre après l'installation
<a name="install-post"></a>

Après l'installation AWS ParallelCluster, vous devrez peut-être ajouter le chemin du fichier exécutable à votre `PATH` variable. Pour obtenir des instructions spécifiques à la plate-forme, consultez les rubriques suivantes :
+ **Linux** : [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](install-linux.md#install-linux-path)
+ **macOS** : [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](install-macos.md#install-macos-path)
+ **Windows** – [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](install-windows.md#install-windows-path)

Vous pouvez vérifier qu'il AWS ParallelCluster est correctement installé en exécutant`pcluster version`.

```
$ pcluster version
2.11.9
```

AWS ParallelCluster est régulièrement mis à jour. Pour effectuer la mise à jour vers la dernière version de AWS ParallelCluster, réexécutez la commande d'installation. Pour plus de détails sur la dernière version de AWS ParallelCluster, consultez les [notes AWS ParallelCluster de publication](https://github.com/aws/aws-parallelcluster/blob/v2.11.9/CHANGELOG.md).

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

Pour désinstaller AWS ParallelCluster, utilisez`pip uninstall`.

```
$ pip3 uninstall "aws-parallelcluster<3.0"
```

Si vous n'avez pas Python ni `pip`, utilisez la procédure indiquée pour votre environnement.

## Instructions détaillées pour chaque environnement
<a name="install-sections"></a>
+ [Installation AWS ParallelCluster dans un environnement virtuel (recommandé)](install-virtualenv.md)
+ [Installation AWS ParallelCluster sous Linux](install-linux.md)
+ [Installation AWS ParallelCluster sur macOS](install-macos.md)
+ [Installation AWS ParallelCluster sous Windows](install-windows.md)

# Installation AWS ParallelCluster dans un environnement virtuel (recommandé)
<a name="install-virtualenv"></a>

Nous vous recommandons d'effectuer l'installation AWS ParallelCluster dans un environnement virtuel afin d'éviter tout conflit de version entre les exigences et les autres `pip` packages.

**Prérequis**
+ Vérifiez que `pip` et Python sont installés. Nous recommandons `pip3` la version 3.8 de Python 3. Si vous utilisez Python 2, utilisez `pip` au lieu de `pip3` et `virtualenv` au lieu de `venv`.

**Pour effectuer une installation AWS ParallelCluster dans un environnement virtuel**

1. Si `virtualenv` n'est pas installé, installez `virtualenv` à l'aide de `pip3`. Si `python3 -m virtualenv help` affiche des informations d'aide, passez à l'étape 2.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m pip install --upgrade pip
   $ python3 -m pip install --user --upgrade virtualenv
   ```

   Exécutez `exit` pour quitter la fenêtre de terminal actuelle et ouvrir une nouvelle fenêtre de terminal afin de récupérer les modifications apportées à l'environnement.

------
#### [ Windows ]

   ```
   C:\>pip3 install --user --upgrade virtualenv
   ```

   Exécutez `exit` pour quitter l'invite de commandes actuelle et ouvrir une nouvelle invite de commandes afin de récupérer les modifications apportées à l'environnement.

------

1. Créez et nommez un environnement virtuel.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ python3 -m virtualenv ~/apc-ve
   ```

   Vous pouvez également utiliser l'option `-p` pour spécifier une version spécifique de Python.

   ```
   $ python3  -m virtualenv -p $(which python3) ~/apc-ve
   ```

------
#### [ Windows ]

   ```
   C:\>virtualenv %USERPROFILE%\apc-ve
   ```

------

1. <a name="activate-virtual-environment"></a>Activez votre nouvel environnement virtuel.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ source ~/apc-ve/bin/activate
   ```

------
#### [ Windows ]

   ```
   C:\>%USERPROFILE%\apc-ve\Scripts\activate
   ```

------

1. Effectuez AWS ParallelCluster l'installation dans votre environnement virtuel.

------
#### [ Linux, macOS, or Unix ]

   ```
   (apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
   ```

------

1. Vérifiez qu'il AWS ParallelCluster est correctement installé.

------
#### [ Linux, macOS, or Unix ]

   ```
   $ pcluster version
   2.11.9
   ```

------
#### [ Windows ]

   ```
   (apc-ve) C:\>pcluster version
   2.11.9
   ```

------

La commande `deactivate` vous permet de quitter l'environnement virtuel. Chaque fois que vous démarrez une session, vous devez [réactiver l'environnement.](#activate-virtual-environment)

Pour effectuer une mise à niveau vers la dernière version de AWS ParallelCluster, réexécutez la commande d'installation.

------
#### [ Linux, macOS, or Unix ]

```
(apc-ve)~$ python3 -m pip install --upgrade "aws-parallelcluster<3.0"
```

------
#### [ Windows ]

```
(apc-ve) C:\>pip3 install --upgrade "aws-parallelcluster<3.0"
```

------

# Installation AWS ParallelCluster sous Linux
<a name="install-linux"></a>

Vous pouvez installer AWS ParallelCluster et ses dépendances sur la plupart des distributions Linux en utilisant `pip` un gestionnaire de paquets pour Python. Tout d'abord, déterminez si Python et `pip` sont installés :

1. Pour déterminer si votre version de Linux comprend Python et `pip`, exécutez `pip --version`.

   ```
   $ pip --version
   ```

   Si vous l'avez `pip` installé, passez à la rubrique [Installer AWS ParallelCluster avec pip](install.md). Sinon, poursuivez avec l’étape 2

1. Pour déterminer si Python est installé, exécutez `python --version`.

   ```
   $ python --version
   ```

   Si Python 3 version 3.6\$1 ou Python 2 version 2.7 est installé, passez à la rubrique [Installer AWS ParallelCluster avec pip](install.md). Sinon, [installez Python](install-linux-python.md), puis revenez à cette procédure pour installer `pip`.

1. Installez `pip` en utilisant le script fourni par *Python Packaging Authority*. 

1. Utilisez la commande `curl` pour télécharger le script d'installation.

   ```
   $ curl -O https://bootstrap.pypa.io/get-pip.py
   ```

1. Exécutez le script avec Python pour télécharger et installer manuellement la version la plus récente de `pip` et des autres packages de prise en charge requis.

   ```
   $ python get-pip.py --user
   ```

   or

   ```
   $ python3 get-pip.py --user
   ```

   Lorsque vous incluez le commutateur `--user`, le script `pip` s'installe dans le chemin d'accès `~/.local/bin`.

1. Pour vérifier que le dossier qui contient `pip` fait partie de votre `PATH` variable, procédez comme suit :

   1. Recherchez le script de profil de votre shell dans votre dossier utilisateur. Si vous n'êtes pas certain du shell utilisé, exécutez `basename $SHELL`.

      ```
      $ ls -a ~
      .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
      ```
      + **Bash** — `.bash_profile``.profile`, ou `.bash_login`
      + **Zsh** : `.zshrc`
      + **Tcsh** —`.tcshrc`, ou `.cshrc` `.login`

   1. Ajoutez une commande d'exportation à la fin de votre script de profil similaire à l'exemple suivant.

      ```
      export PATH=~/.local/bin:$PATH
      ```

      Cette commande ajoute le chemin d'accès, `~/.local/bin` dans cet exemple, devant la variable `PATH` actuelle.

   1. Rechargez le profil dans la session en cours pour appliquer ces modifications.

      ```
      $ source ~/.bash_profile
      ```

1. Vérifiez que `pip` est installé correctement.

   ```
   $ pip3 --version
   pip 21.3.1 from ~/.local/lib/python3.6/site-packages (python 3.6)
   ```

**Topics**
+ [Installation AWS ParallelCluster avec `pip`](#install-linux-with-pip)
+ [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](#install-linux-path)
+ [Installation de Python sous Linux](install-linux-python.md)

## Installation AWS ParallelCluster avec `pip`
<a name="install-linux-with-pip"></a>

`pip`À utiliser pour installer AWS ParallelCluster.

```
$ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user
```

Lorsque vous utilisez le commutateur `--user`, `pip` installe AWS ParallelCluster sur `~/.local/bin`. 

Vérifiez qu'il AWS ParallelCluster est correctement installé.

```
$ pcluster version
2.11.9
```

Pour effectuer une mise à niveau vers la dernière version, exécutez à nouveau la commande d'installation.

```
$ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user
```

## Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande
<a name="install-linux-path"></a>

Après avoir effectué l'installation avec `pip`, vous allez peut-être devoir ajouter le fichier exécutable `pcluster` à la variable d'environnement `PATH` de votre système d'exploitation.

Pour vérifier le dossier dans lequel il `pip` est installé AWS ParallelCluster, exécutez la commande suivante.

```
$ which pcluster
/home/username/.local/bin/pcluster
```

Si vous avez omis le `--user` commutateur lors de l'installation AWS ParallelCluster, l'exécutable se trouve peut-être dans le `bin` dossier de votre installation Python. Si vous ne savez pas où est installé Python, exécutez cette commande.

```
$ which python
/usr/local/bin/python
```

Notez que la sortie peut être le chemin d'accès vers un lien symbolique, et non le fichier exécutable. Pour savoir où se situent les points du lien symbolique, exécutez `ls -al`.

```
$ ls -al $(which python)
/usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6
```

S'il s'agit du même dossier que celui que vous avez ajouté au chemin d'accès à l'étape 3 dans [Installation AWS ParallelCluster](install.md), vous avez terminé. Dans le cas contraire, vous devez effectuer à nouveau les étapes 3a à 3c, en ajoutant ce dossier supplémentaire au chemin.

# Installation de Python sous Linux
<a name="install-linux-python"></a>

Si votre distribution n'est pas fournie avec Python ou est fournie avec une version antérieure, installez Python avant d'installer `pip` et AWS ParallelCluster.

**Pour installer Python 3 sous Linux**

1. Vérifiez si Python est déjà installé.

   ```
   $ python3 --version
   ```

   or

   ```
   $ python --version
   ```
**Note**  
Si votre distribution Linux a été fournie avec Python, il se peut que vous ayez besoin d'installer le package développeur Python. Le package développeur inclut les en-têtes et les bibliothèques requises pour compiler les extensions et pour installer AWS ParallelCluster. Utilisez votre gestionnaire de package pour installer le package développeur. Il est généralement nommé `python-dev` ou `python-devel`.

1. Si Python 2.7 ou version ultérieure n'est pas installé, installez Python à l'aide du gestionnaire de package de votre distribution. Le nom de la commande et du package varie :
   + Sur les dérivés Debian, comme Ubuntu, utilisez `apt`.

     ```
     $ sudo apt-get install python3
     ```
   + Sur Red Hat et dérivés, utilisez `yum`.

     ```
     $ sudo yum install python3
     ```
   + Sur SUSE et dérivés, utilisez `zypper`.

     ```
     $ sudo zypper install python3
     ```

1. Ouvrez une invite de commande ou un shell et exécutez la commande suivante pour vérifier que Python est installé correctement.

   ```
   $ python3 --version
   Python 3.8.11
   ```

# Installation AWS ParallelCluster sur macOS
<a name="install-macos"></a>

**Topics**
+ [Prérequis](#install-bundle-macos-os-prereq)
+ [Installation AWS ParallelCluster sur macOS à l'aide de pip](#install-macos-pip)
+ [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](#install-macos-path)

## Prérequis
<a name="install-bundle-macos-os-prereq"></a>
+ Python 3 version 3.7\$1 ou Python 2 version 2.7

Vérifiez votre installation de Python.

```
$ python --version
```

Si Python n'est pas déjà installé sur votre ordinateur, ou si vous souhaitez installer une version différente de Python, suivez la procédure de la section [Installation AWS ParallelCluster sous Linux](install-linux.md).

## Installation AWS ParallelCluster sur macOS à l'aide de pip
<a name="install-macos-pip"></a>

Vous pouvez également l'utiliser `pip` directement pour installer AWS ParallelCluster. Si vous disposez de `pip`, suivez les instructions décrites dans la [rubrique d'installation](install.md) principale. Exécutez `pip3 --version` pour déterminer si votre version de macOS comprend déjà Python et `pip3`.

```
$ pip3 --version
```

**Pour installer AWS ParallelCluster sur macOS**

1. Téléchargez et installez la dernière version de Python à partir de la [page de téléchargement](https://www.python.org/downloads/mac-osx/) de [Python.org](https://www.python.org).

1. Téléchargez et exécutez le script d'installation `pip3` fourni par Python Packaging Authority.

   ```
   $ curl -O https://bootstrap.pypa.io/get-pip.py
   $ python3 get-pip.py --user
   ```

1. Utilisez votre appareil nouvellement installé `pip3` pour l'installer AWS ParallelCluster. Si vous utilisez Python version 3\$1, nous vous recommandons d'utiliser la commande `pip3`.

   ```
   $ python3 -m pip install "aws-parallelcluster<3.0" --upgrade --user
   ```

1. Vérifiez qu'il AWS ParallelCluster est correctement installé.

   ```
   $ pcluster version
   2.11.9
   ```

   Si le programme est introuvable, [ajoutez-le à votre chemin de ligne de commande](#install-macos-path).

Pour effectuer une mise à niveau vers la dernière version, exécutez à nouveau la commande d'installation.

```
$ pip3 install "aws-parallelcluster<3.0" --upgrade --user
```

## Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande
<a name="install-macos-path"></a>

Après avoir effectué l'installation à l'aide de `pip`, vous allez peut-être devoir ajouter le programme `pcluster` à la variable d'environnement `PATH` de votre système d'exploitation. L'emplacement du programme dépend de l'endroit où Python est installé.

**Example AWS ParallelCluster emplacement d'installation - macOS avec Python 3.6 et `pip` (mode utilisateur)**  

```
~/Library/Python/3.6/bin
```
Remplacez votre version de Python par celle de l'exemple précédent.

Si vous ne savez pas où est installé Python, exécutez `which python`.

```
$ which python3
/usr/local/bin/python3
```

La sortie pourrait être le chemin d'accès à un lien symbolique, et non le chemin d'accès au programme réel. Exécutez `ls -al` pour voir vers où il pointe.

```
$ ls -al /usr/local/bin/python3
lrwxr-xr-x  1 username  admin  36 Mar 12 12:47 /usr/local/bin/python3 -> ../Cellar/python/3.6.8/bin/python3
```

`pip` installe les programmes dans le dossier qui contient l'application Python. Ajoutez ce dossier à votre variable `PATH`.

**Pour modifier votre `PATH` variable (Linux, macOS ou Unix)**

1. Recherchez le script de profil de votre shell dans votre dossier utilisateur. Si vous n'êtes pas certain du shell utilisé, exécutez `echo $SHELL`.

   ```
   $ ls -a ~
   .  ..  .bash_logout  .bash_profile  .bashrc  Desktop  Documents  Downloads
   ```
   + **Bash** — `.bash_profile``.profile`, ou `.bash_login`
   + **Zsh** : `.zshrc`
   + **Tcsh** — `.tcshrc``.cshrc`, ou `.login`

1. Ajoutez une commande d'exportation à votre script de profil.

   ```
   export PATH=~/.local/bin:$PATH
   ```

   Cette commande ajoute un chemin d'accès, `~/.local/bin` dans cet exemple, à la variable `PATH` actuelle.

1. Chargez le profil dans la session en cours.

   ```
   $ source ~/.bash_profile
   ```

# Installation AWS ParallelCluster sous Windows
<a name="install-windows"></a>

Vous pouvez l'installer AWS ParallelCluster sous Windows en utilisant`pip`, qui est un gestionnaire de paquets pour Python. Si vous disposez déjà de `pip`, suivez les instructions décrites dans la [rubrique d'installation](install.md) principale.

**Topics**
+ [Installation AWS ParallelCluster à l'aide de Python et `pip` sous Windows](#install-windows-pip)
+ [Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande](#install-windows-path)

## Installation AWS ParallelCluster à l'aide de Python et `pip` sous Windows
<a name="install-windows-pip"></a>

La Python Software Foundation fournit des programmes d'installation pour Windows qui incluent `pip`.

**Pour installer Python et `pip` (Windows)**

1. Téléchargez le programme d'installation Windows x86-64 de Python à partir de la [page de téléchargements](https://www.python.org/downloads/windows/) de [Python.org](https://www.python.org).

1. Exécutez le programme d'installation.

1. Choisissez **Add Python 3 to PATH**.

1. Choisissez **Install Now (Installer maintenant)**.

Le programme d'installation installe Python dans votre dossier d'utilisateur et ajoute ses répertoires de programme à votre chemin d'utilisateur.

**Pour installer AWS ParallelCluster avec `pip3` (Windows)**

Si vous utilisez Python version 3\$1, nous vous recommandons d'utiliser la commande `pip3`.

1. Ouvrez l'**Invite de commandes Windows** dans le menu **Démarrer**.

1. Utilisez les commandes suivantes pour vérifier que Python et `pip` sont tous deux installés correctement.

   ```
   C:\>py --version
   Python 3.8.11
   C:\>pip3 --version
   pip 21.3.1 from c:\python38\lib\site-packages\pip (python 3.8)
   ```

1. Installez à AWS ParallelCluster l'aide de`pip`.

   ```
   C:\>pip3 install "aws-parallelcluster<3.0"
   ```

1. Vérifiez qu'il AWS ParallelCluster est correctement installé.

   ```
   C:\>pcluster version
   2.11.9
   ```

Pour effectuer une mise à niveau vers la dernière version, exécutez à nouveau la commande d'installation.

```
C:\>pip3 install --user --upgrade "aws-parallelcluster<3.0"
```

## Ajoutez l' AWS ParallelCluster exécutable au chemin de votre ligne de commande
<a name="install-windows-path"></a>

Après avoir installé AWS ParallelCluster avec`pip`, ajoutez le `pcluster` programme à la variable d'`PATH`environnement de votre système d'exploitation.

Vous pouvez trouver où le programme `pcluster` est installé en exécutant la commande suivante.

```
C:\>where pcluster
C:\Python38\Scripts\pcluster.exe
```

Si cette commande ne renvoie aucun résultat, vous devez ajouter le chemin d'accès manuellement. Utilisez la ligne de commande ou l'Explorateur Windows pour découvrir où il est installé sur votre ordinateur. Les chemins incluent généralement :
+ **Python 3 et `pip3`** — `C:\Python38\Scripts\`
+ **Python 3 et option `pip3` --user —** `%APPDATA%\Python\Python38\Scripts`

**Note**  
Les noms de dossiers qui incluent les numéros de version peuvent varier. Les exemples précédents montrent Python38. Remplacez au besoin par le numéro de version que vous utilisez.

**Pour modifier votre variable PATH (Windows)**

1. Appuyez sur la touche Windows et entrez **environment variables**.

1. Sélectionnez **Modifier les variables d'environnement pour votre compte**.

1. Choisissez **PATH**, puis **Modifier**.

1. Ajoutez le chemin au champ de **Valeur de variable**. Par exemple : ***C:\$1new\$1path***

1. Choisissez **OK** deux fois pour appliquer les nouveaux paramètres.

1. Fermez toute invite de commande en cours d'exécution et rouvrez une invite de commande.