Conectar a Amazon S3

Descubra cómo crear una conexión a Amazon S3 para utilizarla como destino para OCI GoldenGate.

Antes de empezar

Antes de crear la conexión, asegúrese de lo siguiente:

Revise cómo se conecta OCI GoldenGate a su origen y destinos.
Configure las políticas necesarias para permitir el acceso seguro a Vault y Secrets, como el uso de secretos, el uso de almacenes y la lectura de paquetes secretos. Para obtener más información, consulte Políticas mínimas recomendadas.

Creación de la conexión

Para crear una conexión de Amazon S3:

En la página Visión general de OCI GoldenGate, haga clic en Conexiones.
También puede hacer clic en Crear conexión en la sección Introducción y saltar al paso 3.
En la página Conexiones, haga clic en Crear conexión.
En la página Create Connection, complete los campos de la siguiente forma:
1. En Nombre, introduzca un nombre para la conexión.
2. (Opcional) En Descripción, introduzca una descripción que le ayude a distinguir esta conexión de otras.
3. (Solo en GoldenGate en multinube) Seleccione su suscripción y, a continuación, complete los siguientes campos.
  1. En la lista desplegable Compartimento, seleccione el compartimento en el que reside la anclaje de recursos.
  2. Seleccione la región de socio multinube.
  3. Seleccione la zona de disponibilidad de partners. Las opciones disponibles se rellenan en función de la región de socio multinube seleccionada.
4. En Compartimento, seleccione el compartimento en el que desea crear la conexión.
5. En Tipo, seleccione Amazon S3.
6. En ID de clave de acceso, introduzca el ID de clave de acceso de Amazon S3.
  
  Nota
  
  El ID de clave de acceso debe contener solo caracteres alfanuméricos y guiones bajos, y tener entre 16 y 128 caracteres de longitud.
7. Seleccione el secreto de clave de acceso secreto. Si se encuentra en un compartimento diferente, utilice la lista desplegable para cambiar los compartimentos.
  Nota
  - Los secretos son credenciales como contraseñas, certificados, claves SSH o tokens que se utilizan con los servicios de OCI. Para crear un secreto, consulte Creación de un secreto. Asegúrese de que:
    
    Seleccione Generación manual de secretos.
    
    Pegue las credenciales en Contenido secreto.
  - Si prefiere no utilizar secretos de contraseña, asegúrese de anular la selección de Usar secretos en almacén en la sección Seguridad, en Opciones avanzadas, ubicada en la parte inferior de este formulario.
8. En Región, introduzca el nombre de la región en la que reside el cubo.
9. En Punto final, introduzca el punto final de Amazon VPC para S3.
10. Consulte Mostrar Opciones Avanzadas. Puede configurar las siguientes opciones:
  - Seguridad
    - Anule la selección de Usar secretos de almacén si prefiere no utilizar secretos de contraseña para esta conexión. Si no está seleccionado:
      
      Seleccione Usar clave de cifrado gestionada por Oracle para dejar toda la gestión de claves de cifrado a Oracle.
      
      Seleccione Usar clave de cifrado gestionada por el cliente para seleccionar una clave de cifrado específica almacenada en OCI Vault para cifrar las credenciales de conexión.
  - Conectividad de Red
    - Punto final compartido, para compartir un punto final con el despliegue asignado. Debe permitir la conectividad desde la IP de entrada del despliegue.
    - Punto final dedicado, para el tráfico de red a través de un punto final dedicado en la subred asignada en la VCN. Debe permitir la conectividad desde las IP de entrada de esta conexión.
      Nota
      
      Si una conexión dedicada permanece sin asignar durante siete días, el servicio la convierte en una conexión compartida.
      
      Obtenga más información sobre la conectividad de Oracle GoldenGate.
  - Atributos de seguridad: agregue atributos de seguridad para controlar el acceso a esta conexión mediante Enrutamiento de paquetes de confianza cero (ZPR).
  - Etiquetas: agregue etiquetas para organizar los recursos.
Haga clic en Crear.

Una vez creada la conexión, esta aparecerá en la lista Conexiones. Asegúrese de asignar la conexión a un despliegue para utilizarla como destino en una replicación.

Problemas conocidos con Amazon S3

Problema con las conexiones de Amazon S3 en OCI GoldenGate

Si encuentra el siguiente error al usar conexiones de Amazon S3, abra un ticket de soporte, comparta los detalles y el mensaje de error.

ERROR 2024-03-04 11:42:31.000505 [TaskEngine_2(FileFinalizeTask)] - Verify S3 bucket
      [ggstest] failed.com.amazonaws.SdkClientException: Unable to execute HTTP request: s3.us-east-2.amazonaws.com

A continuación, puede utilizar los siguientes pasos como solución temporal.

Solución:

Conéctese a Cloud Shell.

Cree una nueva conexión de Amazon S3 mediante el siguiente ejemplo de la CLI:

oci goldengate connection create-amazon-s3-connection --routing-method SHARED_SERVICE_ENDPOINT --display-name <connection_name> --compartment-id <compartment_ocid> --technology-type AMAZON_S3 --access-key-id <aws_access_key> --secret-access-key <aws_secret> --connection-region <amazon_s3_bucket_region>

Asigne la conexión a su despliegue.
Agregue y ejecute Replicat para Amazon S3.

Como alternativa, si prefiere no utilizar el acceso público, configure los cubos de la conexión de Amazon S3 para que utilicen AWS VPC Endpoints. Para que OCI GoldenGate acceda al cubo S3 mediante VPC Endpoints, también debe configurar una VPN IPsec entre la VCN y la VPC de AWS.

Para definir el punto final para Amazon S3, agregue la propiedad gg.eventhandler.s3.url al archivo de propiedades de Replicat y proporcione el punto final para la conexión privada.

Errores de Java.net.UnknownHostException para conexiones de Amazon S3 y Google Cloud Storage con puntos finales compartidos

Al utilizar conexiones de Amazon S3 y Google Cloud Storage con puntos finales compartidos, puede encontrar errores de Java.net.UnknownHostException.

Solución alternativa: edite la conexión y cambie el método de enrutamiento de tráfico a Dedicado o seleccione Dedicado al crear conexiones de Amazon S3 y Google Cloud Storage.