Étape 3 : Installer apigeectl

Vous consultez actuellement la version 1.11 de la documentation d'Apigee hybrid. Pour en savoir plus, consultez la section Versions compatibles.

Version 1.11 

   Versions compatibles :

• v1.13 (la plus récente)
• v1.12
• v1.11                         
• Liste des versions compatibles

   Versions non compatibles :

• v1.10
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Cette étape explique comment télécharger et installer apigeectl.

Télécharger et installer apigeectl

apigeectl est l'interface de ligne de commande (CLI) permettant d'installer et de gérer Apigee hybrid dans un cluster Kubernetes.

Les étapes suivantes décrivent comment télécharger et installer apigeectl :

Linux

1. Stockez le dernier numéro de version dans une variable à l'aide de la commande suivante :

   export VERSION=$(curl -s \
       "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

2. À l'aide de la commande suivante, vérifiez que le numéro de version a bien été enregistré dans la variable. Si vous souhaitez utiliser une autre version, vous pouvez l'enregistrer dans une variable d'environnement à la place.

   echo $VERSION

     1.11.1

3. Téléchargez le package de version de votre système d'exploitation à l'aide de la commande suivante :

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

4. Créez un répertoire sur votre système qui servira de répertoire de base pour l'installation d'Apigee hybrid.

5. À l'aide de la commande suivante, extrayez dans le répertoire de base que vous venez de créer le contenu du fichier gzip téléchargé :

   tar xvzf filename.tar.gz -C path-to-base-directory

6. Remplacez le répertoire par le répertoire de base à l'aide de la commande cd.

7. Par défaut, le contenu du fichier tar est décompressé dans un répertoire dont le nom contient la version et la plate-forme. Exemple : ./apigeectl_1.11.1-d591b23_linux_64. Changez le nom de ce répertoire en apigeectl à l'aide de la commande suivante :

   mv apigeectl_1.11.1-d591b23_linux_64/ apigeectl

8. Accédez au répertoire à l'aide de la commande suivante :

   cd ./apigeectl

   Ce répertoire correspond au répertoire d'accueil apigeectl. Il s'agit de l'emplacement de la commande exécutable apigeectl.

9. Vérifiez la version de apigeectl à l'aide de la commande version :

   ./apigeectl version

   Version: 1.11.1

10. Créez une variable d'environnement destinée à contenir le chemin d'accès à ce répertoire d'accueil à l'aide de la commande suivante :

    export APIGEECTL_HOME=$PWD

11. Vérifiez que la variable contient le chemin d'accès correct à l'aide de la commande suivante :

    echo $APIGEECTL_HOME

macOS

1. Stockez le dernier numéro de version dans une variable à l'aide de la commande suivante :

   export VERSION=$(curl -s \
       "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

2. À l'aide de la commande suivante, vérifiez que le numéro de version a bien été enregistré dans la variable. Si vous souhaitez utiliser une autre version, vous pouvez l'enregistrer dans une variable d'environnement à la place.

   echo $VERSION

     1.11.1

3. Téléchargez le package de version de votre système d'exploitation à l'aide de la commande suivante :

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

4. Créez un répertoire sur votre système qui servira de répertoire de base pour l'installation d'Apigee hybrid.

5. À l'aide de la commande suivante, extrayez dans le répertoire de base que vous venez de créer le contenu du fichier gzip téléchargé :

   tar xvzf filename.tar.gz -C path-to-base-directory

6. Remplacez le répertoire par le répertoire de base à l'aide de la commande cd.

7. Par défaut, le contenu du fichier tar est décompressé dans un répertoire dont le nom contient la version et la plate-forme. Exemple : ./apigeectl_1.11.1-d591b23_mac_64. Changez le nom de ce répertoire en apigeectl à l'aide de la commande suivante :

   mv apigeectl_1.11.1-d591b23_mac_64 apigeectl

8. Accédez au répertoire à l'aide de la commande suivante :

   cd ./apigeectl

   Ce répertoire correspond au répertoire d'accueil apigeectl. Il s'agit de l'emplacement de la commande exécutable apigeectl.

9. Vérifiez la version de apigeectl à l'aide de la commande version :

   ./apigeectl version

   Version: 1.11.1

10. Créez une variable d'environnement destinée à contenir le chemin d'accès à ce répertoire d'accueil à l'aide de la commande suivante :

    export APIGEECTL_HOME=$PWD

11. Vérifiez que la variable contient le chemin d'accès correct à l'aide de la commande suivante :

    echo $APIGEECTL_HOME

Windows

1. Stockez le dernier numéro de version dans une variable à l'aide de la commande suivante :

   for /f "tokens=*" %a in ('curl -s ^
     https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
   do set VERSION=%a

2. À l'aide de la commande suivante, vérifiez que le numéro de version a bien été enregistré dans la variable. Si vous souhaitez utiliser une autre version, vous pouvez l'enregistrer dans une variable d'environnement à la place.

   echo %VERSION%

     1.11.1

3. Téléchargez le package de version de votre système d'exploitation à l'aide de la commande suivante :

   curl -LO ^
     https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

4. Créez un répertoire sur votre système qui servira de répertoire de base pour l'installation d'Apigee hybrid.

5. Extrayez le contenu du fichier .zip téléchargé dans le répertoire actuel à l'aide de la commande suivante :

   tar xvzf filename.zip -C path-to-base-directory

6. Remplacez le répertoire par le répertoire de base à l'aide de la commande cd.

7. Le contenu du fichier tar est, par défaut, développé dans un répertoire dont le nom contient la version et la plate-forme. Exemple : .\apigeectl_1.11.1-d591b23_windows_64. Changez le nom de ce répertoire en apigeectl à l'aide de la commande suivante :

   rename apigeectl_1.11.1-d591b23_windows_64 apigeectl

8. Accédez au répertoire à l'aide de la commande suivante :

   cd .\apigeectl

   Ce répertoire correspond au répertoire d'accueil apigeectl. Il s'agit de l'emplacement de la commande exécutable apigeectl.

9. Vérifiez la version de apigeectl à l'aide de la commande version :

   ./apigeectl version

   Version: 1.11.1

10. Créez une variable d'environnement destinée à contenir le chemin d'accès à ce répertoire d'accueil à l'aide de la commande suivante :

    set APIGEECTL_HOME=%CD%

11. Vérifiez que la variable contient le chemin d'accès correct à l'aide de la commande suivante :

    echo %APIGEECTL_HOME%

Configurer la structure de répertoire du projet

La structure de répertoire suivante est une suggestion. Elle sépare le logiciel Apigee hybrid des fichiers de configuration que vous devez créer. Grâce à l'utilisation de la variable $APIGEECTL_HOME et des liens symboliques que vous créez, vous pouvez facilement passer à une nouvelle version du logiciel si vous le souhaitez. Consultez également Mise à niveau d'Apigee hybrid.

Remarque : Pour les besoins de ce guide de démarrage rapide, les étapes d'installation qui figurent plus bas sur cette page partent du principe que la structure de votre projet est conforme à celle décrite dans cette section. Si vous respectez ces recommandations quant à la structure de votre projet, vous pouvez copier et coller la plupart des commandes d'installation directement dans votre terminal.

Linux

1. Placez-vous dans le répertoire de base (le répertoire dans lequel se trouve le répertoire apigeectl) à l'aide de la commande suivante :

   cd $APIGEECTL_HOME/..

2. Créez un dossier nommé hybrid-files à l'aide de la commande suivante : Vous pouvez donner un autre nom au répertoire, mais sachez que dans la documentation, c'est toujours le nom hybrid-files qui est utilisé. C'est dans ce répertoire que seront ultérieurement stockés les fichiers de configuration, les clés de compte de service et les certificats TLS. Il sert à séparer vos fichiers de configuration de l'installation du logiciel apigeectl.

   mkdir hybrid-files

3. La structure de répertoire actuelle se présente maintenant comme suit :

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Remplacez le répertoire par le dossier hybrid-files à l'aide de la commande suivante :

   cd hybrid-files

5. Créez une variable d'environnement destinée à contenir le chemin d'accès à votre répertoire hybrid-files :

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

6. Dans le répertoire hybrid-files, créez les sous-répertoires suivants pour organiser les fichiers que vous créerez plus tard :

   mkdir overrides
   mkdir certs

7. Dans le répertoire hybrid-files, créez les liens symboliques suivants vers $APIGEECTL_HOME. Ces liens vous permettent d'exécuter la commande apigeectl à partir du répertoire hybrid-files, comme illustré dans l'exemple suivant :

   Remarque : Si ce n'est pas la première fois que vous utilisez ce processus, il est possible que les liens symboliques suivants existent déjà. Vérifiez si les liens existent déjà à l'aide de la commande suivante. Si les répertoires existent, ignorez cette étape.

   ls -l | grep ^l
   

   ln -s $APIGEECTL_HOME/tools tools
   ln -s $APIGEECTL_HOME/config config
   ln -s $APIGEECTL_HOME/templates templates
   ln -s $APIGEECTL_HOME/plugins plugins

8. Pour vérifier que les liens symboliques ont été créés correctement, exécutez la commande suivante et assurez-vous que les chemins d'accès aux liens pointent vers les emplacements appropriés :

   ls -l | grep ^l

macOS

1. Placez-vous dans le répertoire de base (le répertoire dans lequel se trouve le répertoire apigeectl) à l'aide de la commande suivante :

   cd $APIGEECTL_HOME/..

2. Créez un dossier nommé hybrid-files à l'aide de la commande suivante : Vous pouvez donner un autre nom au répertoire, mais sachez que dans la documentation, c'est toujours le nom hybrid-files qui est utilisé. C'est dans ce répertoire que seront ultérieurement stockés les fichiers de configuration, les clés de compte de service et les certificats TLS. Il sert à séparer vos fichiers de configuration de l'installation du logiciel apigeectl.

   mkdir hybrid-files

3. La structure de répertoire actuelle se présente maintenant comme suit :

   pwd && ls

   /hybrid-base-directory
     apigeectl
     hybrid-files

4. Remplacez le répertoire par le dossier hybrid-files à l'aide de la commande suivante :

   cd hybrid-files

5. Créez une variable d'environnement destinée à contenir le chemin d'accès à votre répertoire hybrid-files :

   export HYBRID_FILES=$PWD

   echo $HYBRID_FILES

6. Dans le répertoire hybrid-files, créez les sous-répertoires suivants pour organiser les fichiers que vous créerez plus tard :

   mkdir overrides
   mkdir certs

7. Dans le répertoire hybrid-files, créez les liens symboliques suivants vers $APIGEECTL_HOME. Ces liens vous permettent d'exécuter la commande apigeectl à partir du répertoire hybrid-files, comme illustré dans l'exemple suivant :

   Remarque : Si ce n'est pas la première fois que vous utilisez ce processus, il est possible que les liens symboliques suivants existent déjà. Vérifiez si les liens existent déjà à l'aide de la commande suivante. Si les répertoires existent, ignorez cette étape.

   ls -l | grep ^l
   

   ln -s $APIGEECTL_HOME/tools tools
   ln -s $APIGEECTL_HOME/config config
   ln -s $APIGEECTL_HOME/templates templates
   ln -s $APIGEECTL_HOME/plugins plugins

8. Pour vérifier que les liens symboliques ont été créés correctement, exécutez la commande suivante et assurez-vous que les chemins d'accès aux liens pointent vers les emplacements appropriés :

   ls -l | grep ^l

Windows

1. Placez-vous dans le répertoire de base (le répertoire dans lequel se trouve le répertoire apigeectl) à l'aide de la commande suivante :

   cd %APIGEECTL_HOME%\..

2. Créez un dossier nommé hybrid-files à l'aide de la commande suivante : Vous pouvez donner un autre nom au répertoire, mais sachez que dans la documentation, c'est toujours le nom hybrid-files qui est utilisé. C'est dans ce répertoire que seront ultérieurement stockés les fichiers de configuration, les clés de compte de service et les certificats TLS. Il sert à séparer vos fichiers de configuration de l'installation du logiciel apigeectl.

   mkdir hybrid-files

3. La structure de répertoire actuelle se présente maintenant comme suit :

   dir

    Directory of C:\Users\example\hybrid
   
   08/05/2021  01:38 PM    <DIR>          .
   08/05/2021  01:38 PM    <DIR>          ..
   08/02/2021  01:11 PM    <DIR>          apigeectl
   08/02/2021  11:13 AM         5,803,963 apigeectl_1.11.1rc1-437dccc_windows_64.zip
   08/05/2021  01:38 PM    <DIR>          hybrid-files

4. Remplacez le répertoire par le dossier hybrid-files.
5. Créez une variable d'environnement destinée à contenir le chemin d'accès à votre répertoire hybrid-files :

   set HYBRID_FILES=%CD%

   echo %HYBRID_FILES%

6. Dans le répertoire hybrid-files, créez les sous-répertoires suivants pour organiser les fichiers que vous créerez plus tard :

   mkdir overrides
   mkdir certs

7. Dans le répertoire hybrid-files, créez les liens symboliques suivants vers $APIGEECTL_HOME. Ces liens vous permettent d'exécuter la commande apigeectl à partir du répertoire hybrid-files, comme le montre l'exemple suivant :
   Remarque : Vous devez disposer de droits d'administrateur sur votre ordinateur Windows pour exécuter la commande mklink. Pour ce faire, exécutez le terminal de commande en tant qu'administrateur ou utilisez la commande runas. Exemple :

   runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
   

   mklink /d config %APIGEECTL_HOME%\config\
   mklink /d plugins %APIGEECTL_HOME%\plugins\
   mklink /d templates %APIGEECTL_HOME%\templates\
   mklink /d tools %APIGEECTL_HOME%\tools\

8. Pour vérifier que les liens symboliques ont été créés correctement, utilisez dir :

   dir

    Directory of C:\Users\example\hybrid\hybrid-files
   
   08/05/2021  01:56 PM    <DIR>          .
   08/05/2021  01:56 PM    <DIR>          ..
   08/05/2021  01:46 PM    <DIR>          certs
   08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
   08/05/2021  01:46 PM    <DIR>          overrides
   08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
   08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
   08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]
       

Vous disposez désormais d'une base principale vous permettant de configurer, de déployer et de gérer Apigee hybrid dans votre cluster Kubernetes. Vous allez ensuite créer les comptes de service Google Cloud et les identifiants requis pour configurer les composants d'exécution hybride.

1 2 3 (SUITE) Étape 4 : Configurer les comptes de service 5 6 7 8 9 10