Incidencias conocidas de las herramientas de desarrollador

Detalles

La versión 2.81.0 del SDK de Java de OCI es incompatible con Java 8. Si utiliza la versión 2.81.0 con Java 8, puede que aparezca el siguiente mensaje de error en tiempo de ejecución:

java.lang.NoSuchMethodError: java.nio.ByteBuffer.flip()Ljava/nio/ByteBuffer;

Para obtener más información, consulte el problema en GitHub.

Solución alternativa

Este problema se ha solucionado en la versión 2.82.0, que restaura la compatibilidad con Java 8. Todas las versiones anteriores a 2.81.0 también son compatibles con Java 8.

Si está usando Java 8, no use la versión 2.81.0, use la versión 2.82.0 o una versión más reciente.

Detalles

Si utiliza la versión 2.66.0 del SDK de Java de OCI, podría ver un mayor consumo de memoria al cargar flujos debido a un almacenamiento en buffer innecesario de todo el flujo en memoria.

Solución alternativa

Este problema se ha solucionado en la versión 2.72.0 y posteriores. Si utiliza la versión afectada, actualice a la versión 2.72.0 o posterior. Para obtener más información y otras posibles soluciones alternativas, consulte el problema en GitHub.

Detalles

Si utiliza cualquier versión del SDK de Java de OCI de 3.31.0 a 3.38.0, podría ver una pérdida de thread en IdleConnectionMonitor. Es posible que se produzca un aumento en el uso de CPU o memoria debido a la proliferación de threads del tipo idle-connection-monitor-thread.

Solución alternativa

Este problema se ha solucionado en la versión 3.39.0 y posteriores. Si utiliza cualquiera de las versiones anteriores afectadas, recomendamos actualizar a la versión 3.39.1 o posterior. Para obtener más información y otras posibles soluciones alternativas, consulte el problema en GitHub.

Detalles

Si utiliza cualquiera de los clientes síncronos del SDK de Java de OCI que cargan flujos de datos (como ObjectStorageClient o DataSafeClient) y no define RetryConfiguration en el nivel de solicitud, las solicitudes no se volverán a intentar automáticamente en las versiones 3.0.0 a 3.31.0. No hay posibilidad de corrupción silenciosa de datos.

Solución alternativa

Este problema se solucionó en la versión 3.31.1 y posteriores. Si utiliza cualquiera de las versiones anteriores afectadas, le recomendamos que actualice a la versión 3.31.1 o posterior. Para obtener más información y otras posibles soluciones alternativas, consulte el problema en GitHub.

Detalles

Es posible que se encuentre el siguiente mensaje de error después de actualizar a las versiones 8u381, 11.0.20, 17.0.8 o 21.0.0 de JDK:

java.lang.ClassNotFoundException: com.oracle.bmc.auth.AbstractAuthenticationDetailsProvider

Este problema se produce porque las versiones de Java mostradas tienen un tamaño de archivo de firma máximo por defecto menor que algunos JAR del SDK de Java. El valor por defecto bajo en Java se abordará y resolverá en las próximas versiones menores de Java.

Solución alternativa nº 1

Para resolver este problema, puede ejecutar Maven con el siguiente parámetro:

-Djdk.jar.maxSignatureFileSize=16000000

Si está compilando con javac, puede utilizar el siguiente comando:

javac -J-Djdk.jar.maxSignatureFileSize=16000000 example.java

Detalles

Si utiliza un SDK de Java de OCI de la versión 2.47.0 a las versiones anteriores a la 2.51.2, puede encontrar un bug en CircuitBreaker que emita un NoSuchElementException. Para obtener más información, consulte https://github.com/oracle/oci-java-sdk/issues/491.

Solución alternativa nº 1

Este problema se resolvió en OCI Java SDK 2.51.2. Actualice a la versión 2.51.2 del SDK de Java de OCI o más reciente.

Solución alternativa nº 2

Si no puede actualizar a la versión 2.51.2 o posterior, puede desactivar y excluir el soporte por defecto del SDK de Java para disyuntores para los clientes de servicio que tengan activados disyuntores del SDK por defecto.

Detalles

Al crear repetidamente nuevos objetos de firmantes/clientes con la autenticación de principales de instancia, principal de recurso y token de delegación, algunos objetos subyacentes no se borran de la memoria, lo que provoca una pérdida de memoria. A partir de nuestras pruebas, la velocidad de crecimiento de la memoria es de ~10 MiB/hora cuando solo se crean objetos cliente/firmante en un bucle infinito. Cloud Shell se ve afectado por el mismo problema cuando los nuevos objetos de cliente se crean repetidamente mediante el SDK de Python. Esto parece provenir de una pérdida de memoria subyacente en el paquete de solicitudes. Para obtener más información, consulte https://github.com/psf/requests/issues/4601.

Solución alternativa nº 1

Evite crear nuevos objetos de firmante/cliente y reutilice los objetos existentes si es posible. Si utiliza la autenticación de token de delegación y necesita actualizar el valor del token de delegación, en el siguiente ejemplo se muestra cómo actualizar un firmante existente en lugar de crear un nuevo firmante:

from oci.auth.signers import InstancePrincipalsDelegationTokenSigner
from oci.object_storage import ObjectStorageClient    

# Create signer and client
delegation_token_signer = InstancePrincipalsDelegationTokenSigner(delegation_token="delegation_token_value")
client = ObjectStorageClient(config={}, signer=delegation_token_signer)    

# Update the delegation token on the client
client.base_client.signer.delegation_token="new_delegation_token_value" 

Solución alternativa nº 2

Utilice el firmante de solicitud sin formato.

Detalles: si está utilizando cualquiera de los clientes síncronos del SDK de la Java de OCI que cargan flujos de datos (por ejemplo, ObjectStorageClient o DataSafeClient) y no define RetryConfiguration en el nivel del cliente o nivel del solicitud, puede que se vea afectado por daños silenciosos de datos.

Solución alternativa: estamos trabajando activamente para solucionar esta incidencia. Para obtener más información y posibles soluciones alternativas, consulte el problema en GitHub.

Enlace directo a esta incidencia: Posible incidencia de corrupción de datos en el SDK de OCI Java con carga de datos binarios mediante reintentos por defecto

Detalles: si está utilizando las versiones 2.14.1 y posteriores del SDK de OCI Java, puede que detecta regresiones de rendimiento al utilizar el SDK para llamar a operaciones del API en cualquiera de los servicios del OCI. La regresión provoca un aumento de entre el 30% y el 60% en la latencia en las operaciones de SDK en cualquiera de los servicios de OCI.

Solución alternativa: para obtener más información y posibles soluciones alternativas, consulte el problema en GitHub.

Enlace directo a este problema: Regresión del rendimiento en la versión 2.14.1 y posteriores de OCI Java SDK para todas las operaciones API

Detalles: a partir de las versiones 2.0.0, el SDK de OCI para Java soporta el uso del ApacheConnectorProvider de Jersey en lugar del valor por defecto HttpUrlConnectorProvider de Jersey para permitir que Apache HttpClient realice llamadas de servicio OCI.

ApacheConnectorProvider soporta el uso de la cabecera Expect por defecto para algunas operaciones del servicio Object Storage (consulte https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/100). Se ha observado que esto provoca una regresión del rendimiento en las mismas operaciones del servicio Object Storage.

final ApacheConnectorProperties apacheConnectorProperties =
        ApacheConnectorProperties.builder()
                .expectContinue(false) // disable the Expect header
                .build();

final ApacheConfigurator configurator =
        new ApacheConfigurator.NonBuffering(apacheConnectorProperties);
        
ObjectStorageClient objectStorageClient =
        ObjectStorageClient.builder()
                .clientConfigurator(configurator)
                .build(provider);

Enlace directo a esta incidencia: Regresión de rendimiento con el proveedor de conector Apache en OCI SDK para Java

Detalles: en la versión 2.0.0 a 2.13.0 de la API del SDK de los Java de OCI, algunas operaciones que devuelven un flujo de datos pero no devuelven la cabecera content-length en la respuesta podrían devolver datos truncados. Esto se debe al cierre prematuro del flujo por parte del SDK antes de leer todos los datos.

Solución alternativa: actualice el cliente Java de SDK de OCI a la versión 2.13.1 o una posterior. Para obtener más información sobre esta incidencia y soluciones alternativas, consulte https://github.com/oracle/oci-java-sdk/issues/357.

Enlace directo a esta incidencia: Respuesta truncada para la operaciones que devuelven datos binarios con el SDK de OCI Java

Detalles: debido a algunas incidencias con una de sus dependencias, la función SDK para Go, que permite a los clientes utilizar automáticamente nuevos dominios que podrían serdos para el SDK, no está funcionando desde Cloud Shell.

can not create client, bad configuration: failed to get security token: failed to renew security token: failed to get security token: failed to call: Post "https://<endpoint>/v1/x509": dial tcp: lookup <endpoint> on 127.0.0.11:53: server misbehaving
panicked while retrying operation. Panic was: runtime error: invalid memory address or nil pointer dereference

Solución alternativa: para resolver esta incidencia, active las regiones mediante el servicio de metadatos de instancia para Go SDK. Para obtener más información, consulte: Adición de Regiones

Detalles: puede que observe un aumento de la latencia en operaciones realizadas a algunos servicios de OCI mediante los SDK, Terraform, Ansible y la CLI. Se ha confirmado que esta incidencia afecta al servicio OCI Streaming, y que puede afectar también a los servicios Email Delivery, Health Checks, NoSQL Database Cloud, Registry, los artefactos genéricos y Web Application Acceleration and Security. Esta lista no es exhaustiva, por lo que es posible que también detecte esta incidencia en otros servicios de OCI. Se ha confirmado que esta incidencia NO afecta a los servicios Object Storage y Functions de OCI.

Los siguientes SDK y herramientas se ven afectados:

Soluciones alternativas y más información: Estamos trabajando activamente para solucionar esta incidencia. Para obtener más información y posibles soluciones alternativas, consulte lo siguiente:

Enlace directo a esta incidencia: Aumento de las incidencias de latencia en operaciones llevadas a cabo para algunos servicios del OCI mediante los SDK y otras herramientas

Detalles: las operaciones copy_boot_volume_backup_and_wait_for_state y copy_volume_backup_and_wait_for_state del compuesto del cliente BlockStorage devuelven 404/NotAuthorizedOrNotFound al copiar una copia de seguridad de la región a otra. Para obtener más información, consulte: https://github.com/oracle/oci-python-sdk/issues/344.

Solución alternativa: en lugar de usar las operaciones del compuesto, utilice dos clientes diferentes para esta operación; un cliente en el región de origen para enviar la solicitud de copia de seguridad de la Región A a la Región B, y un segundo cliente en el estado de destino para esperar a que la copia de seguridad estuviera disponible. Consulte el ejemplo aquí: https://github.com/oracle/oci-python-sdk/blob/master/examples/copy_volume_backup_example.py

Enlace directo a esta incidencia: Las operaciones del compuesto de SDK de Python devuelven un error 404 NotAuthorizedOrNotFound a pesar de que la operación es exitosa

Detalles: el SDK de OCI para TypeScript y JavaScript tiene una incidencia conocida con números grandes mayores que Number.MAX_SAFE_INTEGER de JavaScript. Cualquier número mayor que Number.MAX_SAFE_INTEGER generará una incidencia de redondeo.

Solución alternativa: Tenemos constancia de la incidencia por la que una respuesta a API puede devolver un número mayor que Number.MAX_SAFE_INTERGER de JavaScript. En estos momentos, la incidencia de redondeo de números no afecta a la llamada a ninguna API.

Enlace directo a esta incidencia: Posible incidencia de redondeo de datos para números grandes con el SDK de OCI para TypeScript y JavaScript

Detalles: al utilizar la versión 1.25.1 o anterior de los clientes de SDK Java de OCI que cargan flujos de datos (por ejemplo, ObjectStorageClient o FunctionsInvokeClient), de forma síncrona y asíncrona, y utiliza RefreshableOnNotAuthenticatedProvider (por ejemplo, para los Principales de Recursos o los principales de instancia), puede verse afectado por la corrupción silenciosa de datos.

Solución alternativa: actualice el cliente del SDK Java de OCI a la versión 1.25.2 o una posterior. Para obtener más información sobre esta incidencia y soluciones alternativas, consulte Posible incidencia de daños en los datos con el SDK de Java de OCI en la carga de datos binarios con RefreshableOnNotAuthenticatedProvider.

Enlace directo a esta incidencia: Posible incidencia de daños en la información con el SDK de Java de OCI en la carga del dato binario con RefreshableOnNotAuthenticatedProvider

Detalles: si usa la versión 3.2.1.1 o anterior de los clientes del conector HDFS de OCI y usa RefreshableOnNotAuthenticatedProvider (por ejemplo, InstancePrincipalsCustomAuthenticator o, generalmente, para principales de recurso o de principales de instancia), puede que se vea afectado por daños silenciamientos de los datos.

Solución alternativa: actualice el cliente de conector HDFS para OCI a la versión 3.2.1.3 o una posterior. Para obtener más información sobre esta incidencia y soluciones alternativas, consulte Posible incidencia de daños en los datos para el conector HDFS de OCI con RefreshableOnNotAuthenticatedProvider.

Enlace directo a esta incidencia: Posible incidencia de daños de datos en los datos con el conector HDFS del servicio de datos binarios con RefreshableOnNotAuthenticatedProvider

Detalles: al utilizar el SDK para Python para realizar operaciones del proceso de carga binaria, puede que aparezca un problema relativo con daños de datos si se activan los reintentos o si se está utilizando UploadManager.upload_file

Solución alternativa: estamos intentando solucionar el problema. Para obtener más información sobre este problema y las soluciones alternativas, consulte Posible problema de daños de los datos para el reintento del SDK de Python en la carga de datos binarios.

Enlace directo a este problema: Posibles daño de la información con el SDK para Python en la carga binaria

Actualización: la causa raíz de la incidencia que causa daños en la información se ha corregido con la versión v2.54.0. Utilice oci v2.54.0 o una versión superior para evitar daños en los datos. A continuación se explica el comportamiento de las versiones anteriores del SDK de Python de OCI con respecto a esta incidencia.

Detalles: los clientes que utilizan el SDK de OCI para Python y oci.object_storage.UploadManager.upload_stream en modo FIPS pueden ser vulnerables a daño silencioso en los datos. Si las circunstancias para producir la incidencia son verdaderas para su entorno, el SDK informa que la operación de carga se ha realizado correctamente, pero se carga un objeto de longitud 0.

La resolución varía en función del estado del entorno:

1. El uso de UploadManager.upload_stream() en un entorno que utiliza una versión de OpenSSL compatible con FIPS en el que el SDK para Python no está funcionando en modo FIPS, como se describe en Uso del uso de bibliotecas validadas de FIPS.

   Para determinar si entra dentro de este escenario:

   • Verifique que está utilizando una versión de OpenSSL compatible con FIPS mediante la ejecución del comando openssl version. Si "FIPS" forma parte del nombre de la versión y no está empleando el SDK en modo FIPS, entonces entraría en este escenario.

   • Si oci.fips.is_fips_mode() no devuelve True, quiere decir que el SDK no está funcionando en modo FIPS.

   Solución alternativa: actualice el SDK de OCI para Python a las versiones 2.53.1 o posterior y opere el SDK para Python en modo FIPS, como se describe en Uso del uso de bibliotecas validadas de FIPS.

   Importante
   
   Si no usa el SDK en modo FIPS mientras utiliza una versión de OpenSSL compatible con FIPS, los datos se dañarán al utilizar UploadManager.upload_stream().
2. Using UploadManager.upload_stream() when the SDK for Python is operating in FIPS mode as described in Using FIPS validated libraries and the SDK for Python is v2.53.0 or lower.

   Si oci.fips.is_fips_mode() devuelve True, quiere decir que el SDK está funcionando en modo FIPS.

   Resolución: actualice el SDK de OCI para Python a la versión 2.53.1 o posterior.

Para obtener más información sobre esta incidencia, consulte la sección sobre la posible incidencia de corrupción de datos para la carga de flujos de varias partes para el SDK de Python de OCI en GitHub.

Enlace directo a esta incidencia: Posible incidencia de daño de los datos con el SDK para Python y flujos de carga

Para ver las incidencias conocidas de WebLogic Management, consulte Problemas conocidos.