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 streams, você também pode atualizar suas tags. Para obter mais informações sobre tags, consulte Tags de Recursos.

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

    1. Na página da lista Pools de Streams, selecione o pool de streams com o qual você deseja trabalhar. Se precisar de ajuda para encontrar a página da 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 stream.
    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 vault que contém a chave principal de criptografia que você deseja usar.
      • Chave de criptografia principal: Selecione a chave de criptografia principal que você deseja usar.

      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.
    6. (Opcional) Adicione uma ou mais tags ao pool de streams: na página de detalhes, selecione Tags.
      Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore esta opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

  • 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 obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da 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.