Documentação do Oracle Cloud Infrastructure

Atualizando um Pool de Streams

Altere as definições de um pool de streams para uso e criptografia do Kafka (chave de criptografia principal).

Ao atualizar um pool de fluxos, você também pode atualizar o seguinte:

Para revisar os requisitos de criação e gerenciamento de streams, consulte Conceitos Básicos do Streaming.

    1. Na página de lista Pool de streams, selecione o pool de streams com o qual você deseja trabalhar. Se precisar de ajuda para localizar a página de lista ou o pool de streams, consulte Listando Pools de Streams.
    2. Na página de detalhes, selecione Editar definições.
    3. Para usar o pool de streams com o Kafka, selecione Criar tópicos automaticamente e configure as definições do stream:
      • Período de retenção padrão (Horas): Especifique um número de horas para o período de retenção do stream.
      • Número-padrão de partições: Especifique o número-padrão de partições para o fluxo.
    4. Para criptografar os dados neste pool de fluxos usando sua própria chave de criptografia do serviço Vault, selecione Criptografar usando chaves gerenciadas pelo cliente. Para usar o serviço Vault para suas necessidades de criptografia, você precisa acessar um vault e uma chave e deve permitir que o serviço use a chave.
      • Vault: Selecione o compartimento que contém o vault com a chave mestra de criptografia que você deseja usar e selecione o vault.
      • Chave de criptografia principal: selecione o compartimento que contém a chave principal de criptografia que você deseja usar e, em seguida, selecione a chave.

      Para obter mais informações sobre criptografia com uma chave do serviço Vault gerenciada por você, consulte Visão Geral do Serviço Vault e Gerenciando Chaves.

      Observação

      Você também pode atualizar as definições de criptografia na página de detalhes.

      • Para interromper o uso de uma chave gerenciada pela Oracle em favor de uma chave de criptografia principal do serviço Vault que você gerencia, selecione Designar, selecione um vault e uma chave de criptografia à qual você tem acesso e selecione Designar.
      • Para selecionar outra chave de criptografia principal do serviço Vault que você gerencia, selecione Atualizar, selecione um vault e uma chave de criptografia às quais você tenha acesso e selecione Atualizar.
      • Para remover a chave de criptografia principal do Vault designada e permitir que a Oracle gerencie a chave de criptografia, selecione Cancelar Designação e, em seguida, selecione Cancelar Designação novamente para confirmar a remoção da designação de chave existente.
    5. Selecione Editar definições para salvar as alterações.

  • Use o comando oci streaming admin stream-pool update e os parâmetros necessários para atualizar um pool de streams:

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

    Por exemplo: 

    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\""
}
    Dica

    Forneça uma entrada para --custom-encryption-key-details, --private-endpoint-details e --kafka-settings como JSON formatado válido. Consulte Especificando Entrada Complexa e Usando um Arquivo JSON para Entrada Complexa para obter informações sobre a formatação JSON.

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

  • Execute a operação UpdateStreamPool para atualizar um pool de streams.

Usando o Resource Manager e o Terraform

Atualize o recurso oci_streaming_stream_pool na configuração do Terraform e edite sua pilha ou execute um job terraform apply.

Sobre o Resource Manager e o Terraform

O Resource Manager é um serviço do OCI (Oracle Cloud Infrastructure) que permite automatizar o processo de provisionamento dos seus recursos do OCI. Usando o Terraform, o serviço Resource Manager ajuda a instalar, configurar e gerenciar recursos por meio do modelo "infraestrutura como código".

Uma configuração Terraform codifica sua infraestrutura em arquivos de configuração declarativos. A configuração define os recursos que você pretende provisionar, variáveis e instruções específicas para provisionar os recursos

Você pode usar o Resource Manager ou a CLI do Terraform com o provedor Terraform do OCI para ver como seus streams e pools de streams são representados nos arquivos de configuração do Terraform.

Para obter mais informações sobre como gravar configurações para uso com o Resource Manager, consulte Configurações do Terraform para o Resource Manager e a Configuração do Terraform.