Gestionar instancias

Esta página se aplica a Apigee, pero no a Apigee Hybrid.

Consulta la documentación de Apigee Edge.

Una instancia es una máquina virtual en la que se almacenan tu proyecto de API y los servicios relacionados. Las instancias corresponden a regiones. Normalmente, se empieza con una sola instancia y se añaden nuevas instancias a medida que la organización se expande a más regiones. En esta sección se explica cómo:

Crear una instancia

Para crear una instancia, puedes usar la API Instances o la interfaz de usuario de Apigee. Cada instancia requiere lo siguiente:

  • su propia clave de cifrado de disco para la red. Apigee recomienda que también crees un conjunto de claves independiente para la nueva instancia. Para obtener más información, consulta el artículo Acerca de las claves de cifrado de Apigee.
  • Sus propios intervalos CIDR /22 y /28 no superpuestos para el emparejamiento de redes. Los intervalos no se pueden compartir entre instancias.

Apigee en la consola de Cloud

Para crear una instancia en Apigee en la consola de Cloud, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Gestión > Instancias.

    Ir a Instancias

    En el panel Instancias se muestra una lista de las instancias.

  2. Haz clic en + Crear. Puede que haya un retraso mientras la interfaz de usuario determina si tu organización tiene los derechos adecuados para crear una instancia.

    Se muestra la página Crear instancia.

  3. Introduce los detalles de la nueva instancia en los campos:
    Campo Obligatorio Descripción
    Runtime hosting location Obligatorio Selecciona la región en la que quieras crear la instancia. No puedes crear una instancia en una región que ya tenga una. Para obtener más información sobre cómo trabajar con varias regiones, consulta Usar varias regiones.
    Name Obligatorio

    Introduce el ID de la nueva instancia.

    El valor predeterminado es el nombre de la región de alojamiento del tiempo de ejecución que hayas seleccionado, pero puedes cambiarlo por el nombre que quieras, siempre que sigas las reglas de nomenclatura:

    • La longitud mínima es de 2 caracteres.
    • Longitud máxima de 32.
    • Usa solo letras minúsculas, números y guiones (siguiendo el patrón /^[a-z0-9\-]+$/).
    • Debe empezar por una letra y no puede incluir números ni guiones al principio.
    • Debe terminar con un número o una letra, y no puede incluir guiones al final.
    • Debe ser único en toda tu organización.
    IP range allocation Obligatorio

    Especifica cómo quieres asignar un intervalo de IP. Puedes elegir una de estas opciones:

    • Automático (recomendado): Apigee selecciona un intervalo CIDR disponible con un tamaño de prefijo de /22. No hace falta que hagas nada más.
    • Personalizado: en casos prácticos avanzados, puede que tengas que especificar exactamente el intervalo de IPs que quieres que use Apigee. En estos casos, debe especificar un intervalo de IP personalizado, que debe tener un tamaño de prefijo de /22. El intervalo debe estar disponible como parte de una conexión privada entre tu proyecto y Apigee.
    Disk encryption key Obligatorio

    En Clave de cifrado de disco, elige una clave de cifrado gestionada por el cliente. Si ya existe una clave, puedes elegirla. El asistente muestra todas las claves de la misma ubicación que la región de alojamiento del tiempo de ejecución en todos los conjuntos de claves. Si no existe ninguna clave o no quieres usar una que ya tengas, puedes crear una desde el asistente. Para crear una clave, sigue estos pasos:

    1. Haz clic en Crear clave.
    2. Selecciona un conjunto de claves o, si no hay ninguno, habilita Crear conjunto de claves, introduce un nombre y elige una ubicación. Los nombres de los conjuntos de claves pueden contener letras, números, guiones bajos (_) y guiones (-). No puedes eliminar los conjuntos de claves ni cambiar su nombre.
    3. Haz clic en Continuar.
    4. Crea una clave. Introduce un nombre y un nivel de protección. Ten en cuenta que los nombres de las claves pueden incluir letras, números, guiones bajos (_) y guiones (-). No es posible cambiar el nombre de las claves ni eliminarlas. En cuanto al nivel de protección, Software es una buena opción. Este es el mismo valor predeterminado que usa Cloud KMS, pero puedes cambiarlo si quieres.
    5. Haga clic en Continuar y revise sus selecciones.
    6. Haz clic en Crear.
    7. Haz clic en Conceder para conceder a la cuenta de servicio permiso para encriptar o desencriptar con la clave seleccionada.
    Environments Opcional

    Selecciona los entornos que quieras adjuntar a esta instancia. Para ello, haz clic en la lista desplegable Entornos y marca las casillas situadas junto a los entornos que quieras adjuntar. Puedes hacerlo con tantos entornos como quieras. A continuación, haz clic en Aceptar.

    Ten en cuenta que los entornos de todas las instancias se incluyen en el número total de entornos que puedes tener asignados. Para obtener más información, consulta Acerca de los entornos y los grupos de entornos.

    Añadir entornos al crear una instancia es opcional. Si no los añades ahora, puedes usar la API de creación de adjuntos de instancias o la interfaz de usuario para añadirlos y quitarlos más adelante. Consulta Adjuntar o quitar un entorno.

    Accepted projects Opcional Haz clic en Añadir proyecto aceptado para seleccionar uno o varios proyectos de Cloud. Los proyectos seleccionados pueden conectarse de forma privada a la vinculación de servicio de tu instancia. De forma predeterminada, el proyecto asociado a tu organización de Apigee se incluye en esta lista.
    Enable logging Opcional Haz clic en el interruptor Habilitar registro para habilitar los registros de acceso de entrada de Cloud Logging de la instancia. Esta función te permite ver los registros generados por las pasarelas de entrada de tu infraestructura de Apigee, como un balanceador de carga de aplicaciones externo o una pasarela de Anthos, para ayudarte a solucionar problemas con las llamadas a la API de Apigee.

    Para obtener más información, consulta Registrar los registros de acceso de Apigee.

    Filter Opcional Selecciona un código de respuesta HTTP en el cuadro Código de respuesta para que actúe como filtro de los registros de acceso de entrada.

    Si quieres incluir todos los registros, independientemente del código de respuesta HTTP, selecciona None (all HTTP responses).

    Para crear un filtro personalizado, selecciona Custom e introduce el filtro con el siguiente formato:

    status_code > XX && status code <= YY

    Por ejemplo:

    status_code >= 500 && status_code < 504

    Si tu organización no puede crear una instancia, ponte en contacto con el equipo de ventas de Apigee.

  4. Haz clic en Crear.

    Apigee inicia una operación de larga duración que puede tardar 20 minutos o más en completarse. Cuando haya terminado, la nueva instancia aparecerá en la lista de instancias de la interfaz de usuario Instancias.

API de Apigee

Si Apigee se aprovisionó sin el emparejamiento entre VPCs, consulta Crear una instancia de tiempo de ejecución en los pasos de aprovisionamiento sin emparejamiento entre VPCs.

Si Apigee se aprovisionó con el emparejamiento de VPCs, consulta Crear una instancia de tiempo de ejecución en los pasos de aprovisionamiento del emparejamiento de VPCs.

Asociar o eliminar entornos de una instancia

Cuando creas un entorno con la interfaz de usuario de Apigee en la consola, tienes la opción de asignarlo a una instancia. Google Cloud Para obtener más información, consulta Crear un entorno en la interfaz de usuario.

Si no has asociado tu entorno a una instancia durante la creación del entorno o quieres quitar un entorno de una instancia, puedes seguir estos pasos. Para obtener más información sobre los entornos y las instancias, consulta el artículo Entornos e instancias.

Para asociar o quitar un entorno de una instancia mediante Apigee en la consola de Cloud, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Gestión > Instancias.

    Ir a Instancias

  2. Haz clic en la instancia que quieras editar.

  3. En la página Detalles de la instancia, haga clic en Editar.
  4. En la página Editar instancia, haz clic en el campo Entornos (opcional) y selecciona el entorno que quieras asociar a la instancia o desmarca el entorno que quieras quitar.
  5. Haz clic en Aceptar.
  6. Haz clic en Guardar para guardar los cambios.

Además de usar la interfaz de usuario, también puedes adjuntar entornos a una instancia mediante la API Instances attachment create. Para ver un ejemplo, consulta Crear un entorno en la documentación de aprovisionamiento de la línea de comandos.

Editar la lista de proyectos aceptados

Puedes añadir o quitar proyectos de la lista Proyectos aceptados:

  1. En la Google Cloud consola, ve a la página Gestión > Instancias.

    Ir a Instancias

  2. Haz clic en la instancia que quieras editar.

  3. En la página Detalles de la instancia, haga clic en Editar.
  4. En la sección Proyectos aceptados de la página Editar instancia, haz clic en Eliminar junto al proyecto que quieras quitar. Para añadir un proyecto, haz clic en Añadir proyecto aceptado e introduce el ID del proyecto que quieras añadir.
  5. Haz clic en Guardar para guardar los cambios.

Habilitar o inhabilitar los registros de acceso de entrada de una instancia

Una vez que hayas creado una instancia, puedes habilitar e inhabilitar los registros de acceso de entrada de Cloud Logging de la instancia:

  1. En la Google Cloud consola, ve a la página Gestión > Instancias.

    Ir a Instancias

  2. Haz clic en la instancia que quieras editar.

  3. En la página Detalles de la instancia, haga clic en Editar.
  4. En la página Editar instancia, haz clic en el interruptor Habilitar registro para inhabilitar la función.
  5. Haz clic en Guardar para guardar los cambios.

Eliminar una instancia

Puedes usar la interfaz de usuario de Apigee para eliminar una instancia, tal como se describe en esta sección. También puedes eliminar una instancia con la API Instances.

Solo puede haber una instancia de Apigee en una región de Google Cloud determinada. Cuando eliminas una instancia, se elimina por completo de su región. Consulta también la instalación multirregional.

Advertencia: Si eliminas una instancia, se perderán todos los datos asociados a ella. Este paso no se puede deshacer. Sin embargo, ten en cuenta que, si tienes varias instancias, como en una instalación multirregional, tus datos solo se perderán si eliminas todas las instancias. Antes de eliminar la última instancia, asegúrate de extraer y crear una copia de seguridad de los datos que no quieras perder.

Los siguientes datos se almacenan en una instancia de Apigee y se eliminarán si eliminas la instancia:

Tipo de datos Descripción
Sistema de gestión de claves (KMS) Los datos de KMS incluyen productos de API, desarrolladores, aplicaciones para desarrolladores, tokens de OAuth (incluidos los tokens de acceso, los tokens de actualización y los códigos de autorización) y claves de API. Usa la política AccessEntity o la API de Apigee relacionada para recuperar los datos que quieras guardar.
Mapa de clave-valor (KVM) Cualquier dato que se pueda crear o gestionar con políticas de KVM. Consulta Obtener KVMs.
Cuota Definiciones, contenedores y contadores de cuotas.
Caché de entorno Todos los datos almacenados en caché.

Para eliminar una instancia de Apigee mediante la interfaz de usuario de Apigee en la consola de Cloud, sigue estos pasos:

  1. En la Google Cloud consola, ve a la página Gestión > Instancias.

    Ir a Instancias

  2. Haz clic en la instancia que quieras eliminar.
  3. En la página Instance Details (Detalles de la instancia), haz clic en Delete (Eliminar).