Gestionar versiones de conectores personalizados

Crear una versión de conector personalizado

Para crear una versión de conector personalizado, sigue estos pasos:

  1. En la consola, ve a la página Integration Connectors > Custom connectors (Conectores de integración > Conectores personalizados) y, a continuación, selecciona o crea un Google Cloud proyecto.

    Ir a la página Conectores personalizados

    Se muestra la lista de conectores personalizados.

  2. Haz clic en el conector personalizado al que quieras añadir una versión.

    Se muestra la página de detalles de la conexión.

  3. Haz clic en Versiones.

    En la página se muestran todas las versiones del conector.

  4. Haz clic en Crear. Se mostrará la página Crear nueva versión con el nuevo número de versión. Los pasos para crear una versión nueva son similares a los que se siguen para crear un conector personalizado. Esto significa que puedes crear una versión con conectividad directa o indirecta.

Gestionar una versión de conector personalizado

Para editar un conector personalizado, sigue estos pasos:

  1. En la consola, ve a la página Integration Connectors > Custom connectors (Conectores de integración > Conectores personalizados) y, a continuación, selecciona o crea un Google Cloud proyecto.

    Ir a la página Conectores personalizados

    Se muestra la lista de conectores personalizados.

  2. Haz clic en el conector personalizado que tenga versiones.

    Se muestra la página de detalles de la conexión.

  3. Haz clic en Versiones.

    Aparecerán las versiones del conector seleccionado.

  4. Haz clic en Acciones para seleccionar una de las siguientes opciones:
    • Ver detalles: para ver los detalles de la versión del conector personalizado.
    • Obsoleta: para marcar la versión como obsoleta.
    • Eliminar: para eliminar la versión.
    • Exportar: descarga la versión del conector como un archivo de especificación JSON. Para obtener más información, consulta Exportar e importar.

Exportar e importar

Puedes compartir el conector entre diferentes Google Cloud proyectos exportando e importando la especificación del conector. Puede exportar cualquier versión de conexión y, a continuación, importar la especificación al mismo proyecto o a otros Google Cloud proyectos. No se pueden exportar versiones obsoletas del conector.

Roles y permisos necesarios

Para obtener los permisos que necesitas para exportar e importar un conector personalizado, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

  • Administrador de objetos de Storage (roles/storage.objectAdmin) en el cubo de Cloud Storage
  • Administrador de seguridad (roles/iam.securityAdmin) en el proyecto en el que se encuentra el secreto. También puedes pedirle a tu administrador que te conceda a ti o a la cuenta de servicio los permisos secretmanager.secrets.getIamPolicy y secretmanager.secrets.setIamPolicy en el proyecto en el que se encuentra el secreto.

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Exportar un conector personalizado

Para exportar una versión de un conector, sigue estos pasos:

  1. En la consola, ve a la página Integration Connectors > Custom connectors (Conectores de integración > Conectores personalizados) y, a continuación, selecciona o crea un Google Cloud proyecto.

    Ir a la página Conectores personalizados

  2. Haz clic en el conector personalizado que quieras exportar. Se abrirá la página de descripción general del conector personalizado.
  3. Haz clic en Versiones. Se muestra una lista de versiones del conector personalizado.
  4. Haz clic en Más acciones y, a continuación, en Exportar. Se descarga un archivo de especificación JSON para el conector personalizado.

Importar un conector personalizado

Para importar una versión de un conector, sigue estos pasos:

  1. En la consola, ve a la página Integration Connectors > Custom connectors (Conectores de integración > Conectores personalizados) y, a continuación, selecciona o crea un Google Cloud proyecto.

    Ir a la página Conectores personalizados

    2. Se abrirá la página Conectores personalizados.
  2. Haz clic en Importar.
  3. Busca y selecciona el archivo de especificación JSON del conector personalizado. Si importa el conector a otro proyecto, el campo Cuenta de servicio no se rellenará automáticamente.

    En función de si el conector ya existe o no, se pueden dar las siguientes situaciones:

    • No existe ningún conector con el mismo nombre: se muestra la página Crear conector personalizado. La versión del conector del archivo JSON importado se rellena automáticamente. Esta versión no se puede cambiar.
    • Ya existe un conector con el mismo nombre, pero no con la misma versión: se muestra la página Crear versión de ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción, se rellenan automáticamente a partir del conector que ya existe y no se sobrescriben con el JSON importado. Sin embargo, los detalles y el nombre de la versión del conector se leen del JSON importado. Solo se puede editar el nombre de la versión.
    • Ya existe un conector con el mismo nombre y versión: aparece un mensaje de advertencia que indica que la versión ya existe y que se usará una nueva versión al importar la especificación JSON. Si haces clic en Importar, se mostrará la página Crear versión de ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción, se rellenan automáticamente a partir del conector que ya existe y no se sobrescriben con el JSON importado. Sin embargo, los detalles de la versión se leen del JSON importado y se pueden editar. El número de la última versión disponible se usa como nombre de la versión.
  4. Rellena los datos restantes y haz clic en Crear. El conector se crea con la especificación JSON importada.