Partie 1 : Services Google Cloud et configuration de l'interface utilisateur hybride

Avant de commencer

Les étapes décrites dans ce processus d'installation hybride sont réalisées avec l'un ou plusieurs des éléments suivants :

  • Console Google Cloud
  • UI Apigee Hybrid
  • Ligne de commande gcloud

Variables d'environnement

Les étapes effectuées à l'aide de la ligne de commande utilisent des variables d'environnement créées par l'utilisateur. Si votre fenêtre de terminal est déconnectée, les variables d'environnement ne sont pas enregistrées.

Les variables d'environnement utilisées dans ces procédures sont les suivantes :

Linux/MacOS 

export PROJECT_ID="your_project_id"
export ORG_NAME=$PROJECT_ID
export ORG_DISPLAY_NAME="org_friendly_name"
export ORGANIZATION_DESCRIPTION="org_description_text"
export ANALYTICS_REGION="analytics_region"
export RUNTIMETYPE=HYBRID
export ENV_NAME="environment_name"
export ENV_DISPLAY_NAME="env_friendly_name"
export ENV_DESCRIPTION="env_description_text"
export DOMAIN="example.com"
export ENV_GROUP="environment-group-name"
export CLUSTER_NAME="cluster_name"
export CLUSTER_LOCATION="cluster_region"

Les noms de variables contenant des espaces doit être placés entre guillemets doubles. Exemple : 

export ORGANIZATION_DESCRIPTION="My example organization number 1"

Windows 

set PROJECT_ID="your_project_id"
set ORG_NAME=$PROJECT_ID
set ORG_DISPLAY_NAME="org_friendly_name"
set ORGANIZATION_DESCRIPTION="org_description_text"
set ANALYTICS_REGION="analytics_region"
set RUNTIMETYPE=HYBRID
set ENV_NAME="environment_name"
set ENV_DISPLAY_NAME="env_friendly_name"
set ENV_DESCRIPTION="env_description_text"
set DOMAIN="example.com"
set ENV_GROUP="environment-group-name"
set CLUSTER_NAME="cluster_name"
set CLUSTER_LOCATION="cluster_region"

Les noms de variables contenant des espaces doit être placés entre guillemets doubles. Exemple : 

set ORGANIZATION_DESCRIPTION="My example organization number 1"

Jeton d'identifiants d'autorisation

Le jeton d'identifiants d'autorisation gcloud expire au bout de 20 minutes. Si vous n'avez pas terminé toutes les étapes dans ce laps de temps, vous devez de nouveau obtenir les identifiants d'autorisation. Exemple :

Sur la ligne de commande, obtenez vos identifiants d'authentification gcloud à l'aide de la commande suivante :

Linux/MacOS 

TOKEN=$(gcloud auth print-access-token)

Windows 

for /f "tokens=*" %a in ('gcloud auth print-access-token') do set TOKEN=%a

Autres variables d'environnement

Vous serez invité à ajouter d'autres variables d'environnement au cours de ce guide. Vous voudrez peut-être les ajouter au script. Exemple :

  • LONG_RUNNING_OPERATION_ID : UUID de l'opération asynchrone de longue durée qui fait partie du processus de création de l'organisation.
  • APIGEECTL_HOME : chemin d'accès au répertoire dans lequel vous installez l'utilitaire apigeectl.

Présentation du processus

Cette section présente les tâches que vous devez effectuer pour configurer l'interface utilisateur hybride et les services Google Cloud.

Le processus général de configuration de l'interface utilisateur Apigee hybride et des services Google Cloud est le suivant :

Action À l'aide de Description
Étape 1 : Créer un compte Google Cloud Console Google Cloud Vous avez besoin d'un compte Google Cloud pour utiliser ces procédures. Ce compte sera lié à une nouvelle organisation hybride.
Étape 2 : Créer un projet Google Cloud Console Google Cloud Les projets Google Cloud constituent la base de la création, l'activation et l'utilisation des services Google Cloud. Un projet permet d'organiser toutes vos ressources Google Cloud.
Étape 3 : Activer les API La console Google Cloud ou la ligne de commande Sans ces API, les services hybrides ne pourraient pas communiquer entre eux ni avec d'autres services.
Étape 4 : Créez une organisation Ligne de commande Les projets appartiennent à des organisations. Une fois que vous disposez d'une organisation, vous êtes presque prêt à effectuer des appels d'API et à créer des proxys d'API.
Étape 5 : Ajoutez un environnement UI Apigee hybrid ou ligne de commande Un environnement fournit un contexte isolé ou bac à sable pour l'exécution de proxys d'API. Dans une même organisation, vous pouvez créer plusieurs environnements. Si vous ne le faites pas, vous ne pourrez pas terminer l'installation de l'environnement d'exécution hybride ni déployer vos proxys d'API.

Étape suivante

Toutes ces étapes sont décrites plus en détail dans les sections suivantes.

C'est parti !