Administra las versiones de conectores personalizados
Crea una versión de conector personalizada
Para crear una versión de conector personalizada, sigue estos pasos:
-
En la consola, ve a
la página Integration Connectors > Custom Connectors
y, luego, selecciona o crea un proyecto de Google Cloud.
Ve a la página Conectores personalizados
Se mostrará la lista de conectores personalizados.
- Haz clic en el conector personalizado para el que deseas agregar una versión.
Se mostrará la página de detalles de la conexión.
- Haz clic en Versiones.
En la página, se muestran todas las versiones del conector.
- Haz clic en Crear. Se mostrará la página Crear versión nueva con el número de la versión nueva. Los pasos para crear una versión nueva son similares a los de crear un conector personalizado nuevo.
Significa que puedes crear una versión con conectividad directa o indirecta.
- Para crear una versión con conectividad directa, sigue los pasos (desde el paso 3 en adelante) como se indica en Crea un conector personalizado con conectividad directa.
- Para crear una versión con conectividad indirecta, sigue los pasos (a partir del paso 3) que se documentan en Cómo crear un conector personalizado con conectividad indirecta.
Administra una versión de conector personalizado
Para editar un conector personalizado, sigue estos pasos:
-
En la consola, ve a
la página Integration Connectors > Custom Connectors
y, luego, selecciona o crea un proyecto de Google Cloud.
Ve a la página Conectores personalizados
Se mostrará la lista de conectores personalizados.
- Haz clic en el conector personalizado que tiene versiones.
Se mostrará la página de detalles de la conexión.
- Haz clic en Versiones.
Aparecerán las versiones del conector seleccionado.
- Haz clic en
- Ver detalles: Permite ver los detalles de la versión del conector personalizado.
- Dar de baja la versión: Para dar de baja la versión.
- Borrar: Para borrar la versión.
- Exportar: Para descargar la versión del conector como un archivo de especificación JSON. Para obtener más información, consulta Importa y exporta.
Acciones para seleccionar una de las siguientes opciones:
Importa y exporta
Para compartir el conector entre diferentes proyectos de Google Cloud, exporta e importa la especificación del conector. Puedes exportar cualquier versión de conexión y, luego, importar la especificación al mismo proyecto o a diferentes proyectos de Google Cloud. No se admite la exportación de versiones obsoletas del conector.
Roles y permisos requeridos
Para obtener los permisos que necesitas para exportar e importar un conector personalizado, pídele a tu administrador que te otorgue los siguientes roles de IAM:
-
Administrador de objetos de almacenamiento (
roles/storage.objectAdmin
) en el bucket de Cloud Storage -
Administrador de seguridad (
roles/iam.securityAdmin
) en el proyecto en el que se encuentra el secreto Como alternativa, también puedes pedirle a tu administrador que te otorgue a ti o a la cuenta de servicio los permisossecretmanager.secrets.getIamPolicy
ysecretmanager.secrets.setIamPolicy
en el proyecto en el que se encuentra el secreto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Cómo exportar un conector personalizado
Para exportar una versión del conector, sigue estos pasos:
- En la consola, ve a la página Integration Connectors > Custom Connectors y, luego, selecciona o crea un proyecto de Google Cloud.
- Haz clic en el conector personalizado que deseas exportar. Se abrirá la página de descripción general del conector personalizado.
- Haz clic en Versiones. Se muestra una lista de las versiones del conector personalizado.
- Haz clic en Más acciones y, luego, en Exportar. Se descarga un archivo de especificación JSON para el conector personalizado.
Importa un conector personalizado
Para importar una versión del conector, sigue estos pasos:
- En la consola, ve a la página Conectores de Integration > Conectores personalizados y, luego, selecciona o crea un proyecto de Google Cloud. Aparecerá la página Conectores personalizados.
- Haz clic en Importar.
- Explora y selecciona el archivo de especificación JSON para el conector personalizado. Si importas el conector a un proyecto diferente, el campo Cuenta de servicio no se completará automáticamente.
En función de si el conector ya existe o no, las siguientes situaciones pueden ocurrir:
- No existe un conector con el mismo nombre: Aparecerá la página Crear conector personalizado. La versión del conector en el JSON importado está preproporcionada. No se puede cambiar esta versión.
- Existe un conector con el mismo nombre, pero no existe la misma versión: Aparecerá la página Crear versión para ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción del conector, se completan previamente a partir del conector existente y no se reemplazan a partir del JSON importado. Sin embargo, los detalles y el nombre de la versión del conector se leen desde el JSON importado. Solo se puede editar el nombre de la versión.
- Ya existe un conector con el mismo nombre y versión: Aparecerá un mensaje de advertencia que indica que la versión ya existe y que se usará una versión nueva cuando importes la especificación JSON. Si haces clic en Importar, aparecerá la página Crear versión para ese conector. Las propiedades del conector, como el tipo, el nombre y la descripción del conector, se completan previamente a partir del conector existente y no se reemplazan por el JSON importado. Sin embargo, los detalles de la versión se leen desde el JSON importado y se pueden editar. El último número de versión disponible se utiliza para el nombre de la versión.
- Completa los detalles restantes y haz clic en Crear. El conector se crea con la especificación JSON importada.