Primeros pasos con gcloud y Apigee

Esta página se aplica a Apigee y Apigee Hybrid.

Consulta la documentación de Apigee Edge.

La CLI gcloud apigee te permite hacer lo siguiente:

  • Ver proxies de API
  • Crear y gestionar productos de API
  • Desplegar y retirar proxies de API, así como ver los detalles de los despliegues
  • Ver información sobre desarrolladores y aplicaciones
  • Listar tus entornos y organizaciones
  • Gestionar aplicaciones de terceros que llamen a proxies de API de Apigee

Además, la CLI de gcloud beta apigee te permite desplegar y gestionar archivos en tu entorno de Apigee.

En las siguientes secciones se describe cómo instalar, autorizar y usar las CLIs gcloud apigee y gcloud beta apigee, así como cómo definir variables de entorno (opcional).

Antes de empezar

Asegúrate de que cumples los requisitos previos para usar Apigee, incluido el de instalar el SDK de Google Cloud.

Instalar los componentes beta de gcloud apigee

Para acceder a los comandos gcloud beta apigee, debes instalar el componente beta completo de gcloud de la siguiente manera:

gcloud components install beta

Para confirmar que el componente beta se ha instalado, introduce el siguiente comando:

gcloud components list

Debería ver el componente beta en la lista, como se indica a continuación:

Estado Nombre ID Tamaño
Instalada Comandos beta de gcloud beta < 1 MiB

Para obtener más información, consulta Gestionar componentes del SDK.

Autorizar el acceso a gcloud

Autoriza el acceso a la CLI de gloud siguiendo los pasos descritos en Autorizar herramientas del SDK de Cloud.

Por ejemplo, para autorizar el acceso con tu cuenta de usuario y realizar otros pasos de configuración habituales del SDK de Google Cloud, usa el siguiente comando: 

gcloud init

Sigue las indicaciones para autenticar la cuenta, conceder permisos de acceso e inicializar la instalación del SDK de Google Cloud, tal como se describe en el artículo Inicializar el SDK de Google Cloud.

También puedes usar el siguiente comando para autorizar el acceso sin realizar ninguna configuración adicional: 

gcloud auth login

Sigue el flujo de autorización basado en el navegador para autenticar la cuenta y conceder permisos de acceso.

Para obtener más información sobre cómo autorizar y revocar el acceso a la CLI de gcloud, consulta Credenciales.

Configurar variables de entorno para comandos de gcloud

Los ejemplos de la API de Apigee y de la CLI de gcloud que se proporcionan en la documentación usan una o varias de las variables de entorno definidas en la siguiente tabla.

Si asignas valores significativos a las variables de entorno de tu entorno, podrás copiar y pegar las solicitudes de ejemplo para ejecutarlas en tu propio entorno con modificaciones mínimas o sin modificaciones.

Variable de entorno Descripción
$API Nombre del proxy de API.
$APIPRODUCT Nombre del producto de API.
$APP ID de una aplicación.
$DEVELOPER_EMAIL Dirección de correo del desarrollador.
$ENV Nombre de tu entorno, como test o prod.
$ID ID de recurso.
$KEY Clave de consumidor.
$NAME Nombre del recurso.
$ORG Tu organización de Apigee.
$REV Número de revisión de tu proxy de API.
$SHAREDFLOW Nombre del flujo compartido.
$TYPE Tipo de recurso.

Usar la CLI de gcloud

Usa la CLI de gcloud de la siguiente manera: 

gcloud apigee GROUP [GCLOUD_WIDE_FLAG …]

Para obtener más información sobre los grupos de comandos y las marcas disponibles, consulta gcloud apigee.

Por ejemplo, el siguiente comando muestra una lista de los proxies de API de tu organización: 

gcloud apigee apis list --organization=$ORG

A continuación se muestra un ejemplo de la respuesta de la organización my-org: 

Using Apigee organization `myorg`
 - hello-world
 - weather-app

Más información

Para obtener más información, consulta estos artículos: