Gérer l'espace de travail Apigee

Cette page s'applique à Apigee et à Apigee hybrid.

Consultez la documentation d' Apigee Edge.

Pour pouvoir développer vos API Apigee localement à l'aide de Cloud Code, vous devez créer un espace de travail Apigee ou en ouvrir un existant dans Cloud Code. Un espace de travail Apigee contient la structure de répertoires requise pour le développement local.

Les sections suivantes décrivent comment créer, ouvrir et gérer un espace de travail Apigee.

Créer un espace de travail Apigee

Pour créer un espace de travail Apigee :

1. Effectuez l'une des actions suivantes :

   • Cliquez sur Créer un espace de travail Apigee dans la section Apigee si aucun espace de travail Apigee n'est ouvert.

     

   • Cliquez sur Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Créer un espace de travail Apigee.

2. Sélectionnez le type d'espace de travail qui correspond à votre style de développement préféré. Vous pouvez choisir entre un espace de travail à dépôt unique ou un espace de travail multidépôt.

3. Saisissez un nom pour l'espace de travail Apigee.

4. Accédez au répertoire dans lequel vous souhaitez enregistrer l'espace de travail Apigee. Si vous utilisez la gestion du contrôle de code source, sélectionnez un emplacement dans le dépôt source.

5. Cliquez sur Sélectionner le dossier de l'espace de travail. L'espace de travail Apigee est créé, stocké dans le répertoire local spécifié et ouvert dans l'explorateur VS Code.

6. Cliquez sur l'icône Cloud Code dans la barre des tâches.

L'espace de travail Apigee s'affiche dans la section Apigee:

Selon le type d'espace de travail sélectionné, le contenu suivant est créé :

• Pour un espace de travail à dépôt unique, un ensemble de dossiers est créé sous your-workspace-location. Pour en savoir plus, consultez la section Comprendre la structure d'un espace de travail à dépôt unique Apigee.
• Pour un espace de travail multidépôt, un fichier nommé your-workspace-location.code-workspace est créé avec le contenu JSON requis. Pour en savoir plus, consultez la section Comprendre la structure d'un espace de travail multidépôt Apigee.

Ouvrir un espace de travail Apigee

Pour ouvrir un espace de travail Apigee existant :

1. Effectuez l'une des actions suivantes :

   • Cliquez sur Ouvrir l'espace de travail Apigee sur le nœud Développement local d'Apigee Explorer si aucun espace de travail Apigee n'est ouvert.

     

   • Sélectionnez Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Ouvrir l'espace de travail Apigee.

2. Accédez à l'espace de travail Apigee dans votre environnement local.

   • Si vous ouvrez un espace de travail à dépôt unique, sélectionnez le dossier de premier niveau de votre espace de travail Apigee qui contient le dossier src/main/apigee.
   • Si vous ouvrez un espace de travail multidépôt, sélectionnez le fichier de l'espace de travail avec l'extension .code-workspace.

3. Cliquez sur Sélectionner le dossier de l'espace de travail ou le fichier de l'espace de travail multidépôt. L'espace de travail Apigee est ouvert dans Cloud Code, où vous pouvez explorer son contenu.

4. Cliquez sur l'icône Cloud Code dans la barre des tâches.

L'espace de travail Apigee s'affiche dans Apigee Explorer:

Comprendre la structure d'un espace de travail à dépôt unique Apigee

Lorsque vous créez un espace de travail à dépôt unique Apigee dans Apigee Google Cloud, un ensemble de dossiers est créé pour vous permettre de développer des proxys d'API et des flux partagés, de configurer et de déployer des environnements, ainsi que de créer et d'exporter des ressources de test. L'espace de travail Apigee est stocké dans your-workspace-folder/src/main/apigee dans votre environnement local.

Le tableau suivant récapitule la structure générale des espaces de travail Apigee.

Vous trouverez ci-dessous un exemple de structure d'un espace de travail Apigee dans votre environnement local, où src/main/apigee est la racine:

Comprendre la structure d'un espace de travail multidépôt Apigee

Un espace de travail multidépôt fonctionne de la même manière qu'un espace de travail multiracine dans Cloud Code. Il offre aux utilisateurs la possibilité de choisir des emplacements de stockage individuels pour leurs artefacts, mais de les développer conjointement à l'aide d'un seul espace de travail. Par exemple, lorsque l'utilisateur préfère un dépôt de gestion de code source par proxy.

Un espace de travail multidépôt est un fichier texte JSON avec une extension .code-workspace.

Voici un exemple de contenu d'un espace de travail multidépôt contenant deux proxys d'API (authentication-proxy, products-proxy), un flux partagé (SF-threat-protection), deux environnements (dev, test) et un groupe de test (test-products):

{
  "folders": [
    {
      "name": "authentication-proxy",
      "type": "proxy",
      "path": "/work/quickdemo/multi/authentication-proxy"
    },
    {
      "name": "products-proxy",
      "type": "proxy",
      "path": "/work/quickdemo/multi/products-proxy"
    },
    {
      "name": "SF-threat-protection",
      "type": "sharedflow",
      "path": "/work/quickdemo/multi/SF-threat-protection"
    },
    {
      "name": "dev",
      "type": "environment",
      "path": "/work/quickdemo/multi/dev"
    },
    {
      "name": "test",
      "type": "environment",
      "path": "/work/quickdemo/multi/test"
    },
    {
      "name": "test-products",
      "type": "test",
      "path": "/work/quickdemo/multi/test-products"
    }
  ]
}

Ces exigences s'appliquent à chaque type de dossier pouvant être ajouté à un espace de travail multidépôt:

Modifier un espace de travail multidépôt Apigee

Modifiez un espace de travail multidépôt en ouvrant le fichier your-workspace.code-workspace dans Cloud Code ou dans votre éditeur préféré.

Pour ouvrir le fichier à partir de l'extension Apigee dans Cloud Code, procédez comme suit :

• Cliquez sur Modifier l'espace de travail sur le nœud Développement local d'Apigee Explorer.

  

• Sélectionnez Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Modifier l'espace de travail.

Gérer les dossiers et les fichiers dans un espace de travail Apigee

Les sections suivantes décrivent comment gérer des dossiers et des fichiers dans un espace de travail Apigee.

Modifier des fichiers dans un espace de travail Apigee

Pour modifier un fichier dans un espace de travail Apigee, procédez comme suit :

1. Cliquez sur le nom du fichier que vous souhaitez modifier dans l'explorateur Apigee. Le contenu s'affiche dans l'éditeur.

2. Modifiez le fichier selon vos besoins.

3. Sélectionnez File > Save (Fichier > Enregistrer) ou ⌘S pour enregistrer vos modifications.

Copier des dossiers et des fichiers dans un espace de travail Apigee

Pour copier un dossier ou un fichier dans un espace de travail Apigee, procédez comme suit :

1. Effectuez un clic droit sur le dossier ou le fichier que vous souhaitez copier dans l'explorateur Apigee, puis sélectionnez Copier.

2. Saisissez un nom unique pour le dossier ou le fichier et appuyez sur Entrée.

Le dossier ou le fichier copié s'affiche dans l'espace de travail Apigee.

Renommer des dossiers et des fichiers dans un espace de travail Apigee

Pour renommer un dossier ou un fichier dans un espace de travail Apigee, procédez comme suit :

1. Effectuez un clic droit sur le dossier ou le fichier que vous souhaitez copier dans l'explorateur Apigee, puis sélectionnez Rename (Renommer).

2. Saisissez un nom unique pour le dossier ou le fichier et appuyez sur Entrée.

Le dossier ou le fichier est renommé dans Apigee Explorer.

Supprimer des dossiers et des fichiers d'un espace de travail Apigee

Pour supprimer un dossier ou un fichier d'un espace de travail Apigee, effectuez un clic droit sur le dossier ou le fichier que vous souhaitez copier dans Apigee Explorer, puis sélectionnez Supprimer. Le dossier ou le fichier est supprimé de l'espace de travail Apigee.

Actualiser l'affichage de l'espace de travail Apigee

Pour actualiser l'affichage de l'espace de travail Apigee et synchroniser les modifications récentes (éventuellement en dehors de Cloud Code), effectuez l'une des actions suivantes:

• Placez le curseur sur la barre de titre Apigee Explorer, puis cliquez sur .

• Sélectionnez Afficher > Palette de commandes pour ouvrir la palette de commandes, puis sélectionnez Cloud Code : Actualiser la vue Apigee Explorer.