Documentación de Oracle Cloud Infrastructure

Actualización de un pool de flujos

Cambiar la configuración de un pool de flujos para el uso y cifrado de Kafka (clave de cifrado maestra).

Al actualizar un pool de flujos, también puede actualizar lo siguiente:

Para revisar los requisitos para crear y gestionar flujos, consulte Introducción a Streaming.

    1. En la página de lista Grupo de flujos, seleccione el grupo de flujos con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el pool de flujos, consulte Listado de pools de flujos.
    2. En la página de detalles, seleccione Editar configuración.
    3. Para utilizar el pool de flujos con Kafka, seleccione Crear temas automáticamente y configure los valores de flujo:
      • Período de Retención por Defecto (Horas): Especifique un número de horas para el período de retención del flujo.
      • Número de particiones por defecto: especifique el número de particiones por defecto para el flujo.
    4. Para cifrar los datos de los flujos de este pool de flujos mediante su propia clave de cifrado de Vault, seleccione Cifrar mediante claves gestionadas por el cliente. Para utilizar el servicio Vault para sus necesidades de cifrado, necesita tener acceso a un almacén y a una clave, y debe permitir que el servicio utilice la clave.
      • Almacén: seleccione el compartimento que contiene el almacén con la clave que desea utilizar y, a continuación, seleccione el almacén.
      • Clave de cifrado maestra: seleccione el compartimento que contiene la clave que desea utilizar y, a continuación, seleccione la clave.

      Para obtener más información sobre el cifrado con una clave de Almacén que gestione, consulte Visión general de Vault y Gestión de claves.

      Nota

      También puede actualizar la configuración de cifrado desde la página de detalles.

      • Para dejar de utilizar una clave gestionada por Oracle a favor de una clave de cifrado maestra de almacén que gestione, seleccione Asignar, seleccione un almacén y una clave de cifrado a los que tenga acceso y, a continuación, seleccione Asignar.
      • Para seleccionar una clave de cifrado maestra de almacén diferente que gestione, seleccione Actualizar, seleccione un almacén y una clave de cifrado a los que tenga acceso y, a continuación, seleccione Actualizar.
      • Para eliminar la clave de cifrado maestra de Vault asignada y permitir que Oracle gestione la clave de cifrado, seleccione Anular Asignación y, a continuación, seleccione Anular Asignación de nuevo para confirmar la eliminación de la asignación de claves existente.
    5. Seleccione Editar configuración para guardar los cambios.

  • Utilice el comando oci streaming admin stream-pool update y los parámetros necesarios para actualizar un pool de flujos:

    oci streaming admin stream-pool update --stream-pool-id <stream_pool_OCID>

    Por ejemplo:

    oci streaming admin stream-pool update --stream-pool-id ocid1.streampool.oc1.phx.exampleuniqueID --name MyUpdatedStreamPool
{
  "data": {
    "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
    "custom-encryption-key": {
      "key-state": "NONE",
      "kms-key-id": null
    },
    "defined-tags": {},
    "endpoint-fqdn": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com",
    "freeform-tags": {},
    "id": "ocid1.streampool.oc1.phx.exampleuniqueID",
    "is-private": false,
    "kafka-settings": {
      "auto-create-topics-enable": false,
      "bootstrap-servers": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com:9092",
      "log-retention-hours": 24,
      "num-partitions": 1
    },
    "lifecycle-state": "UPDATING",
    "lifecycle-state-details": null,
    "name": "MyUpdatedStreamPool",
    "private-endpoint-settings": {
      "nsg-ids": null,
      "private-endpoint-ip": null,
      "subnet-id": null
    },
    "time-created": "2020-11-02T23:01:59.429000+00:00"
  },
  "etag": "\"6ad44a83-4804-4cb5-87ae-2100d3a7012c-9679fcb9-37b7-48c5-9114-d514f132d363\""
}
    Consejo

    Proporcione una entrada para --custom-encryption-key-details, --private-endpoint-details y --kafka-settings como JSON con formato válido. Consulte Transferencia de entrada compleja y Uso de un archivo JSON para entrada compleja para obtener más información sobre el formato JSON.

    Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de la CLI.

  • Ejecute la operación UpdateStreamPool para actualizar un pool de flujos.

Uso de Resource Manager y Terraform

Actualice el recurso oci_streaming_stream_pool en la configuración de Terraform y edite la pila o ejecute un trabajo terraform apply.

Acerca de Resource Manager y Terraform

Resource Manager es un servicio de Oracle Cloud Infrastructure (OCI) que le permite automatizar el proceso de aprovisionamiento de los recursos de OCI. Con el uso de Terraform, el gestor de recursos le ayuda a instalar, configurar y gestionar recursos con el modelo "infraestructura como código".

Una configuración de Terraform codifica la infraestructura en archivos de configuración declarativos. La configuración define los recursos que desea aprovisionar, las variables y las instrucciones específicas para aprovisionar los recursos

Puede utilizar Resource Manager o la CLI de Terraform con el proveedor de Terraform de OCI para ver cómo se representan los flujos y los pools de flujos en los archivos de configuración de Terraform.

Para obtener más información sobre la escritura de configuraciones para su uso con Resource Manager, consulte Configuraciones de Terraform para el gestor de recursos y Configuración de Terraform.