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 sus etiquetas. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos.

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

    1. En la página de lista Pools de flujos, seleccione el pool de flujos con el que desea trabajar. Si necesita ayuda para buscar la página de lista o el pool de flujos, consulte Lista 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 por defecto de particiones: especifique el número por defecto de particiones 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 almacén que contiene la clave de cifrado maestra que desea utilizar.
      • clave de cifrado maestra: seleccione la clave de cifrado maestra que desea utilizar.

      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.
    6. (Opcional) Agregue una o más etiquetas al pool de flujos: en la página de detalles, seleccione Etiquetas.
      Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.

  • 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.