Criando um Pool de Streams

• Console
• CLI
• API

• 1. Na página da lista Pools de Streams, selecione Criar Pool de Streams. Se precisar de ajuda para localizar a página da lista, consulte Listando Pools de Streams.
  2. Digite um nome para o pool de streams. Evite digitar informações confidenciais.
  3. Selecione o compartimento do pool de streams.
  4. Selecionar Tipo de Ponto Final. Selecione Terminal Público ou Terminal Privado, dependendo de se você deseja restringir o tráfego a fluxos neste pool de fluxos para um ponto final privado que não precise de tráfego para atravessar a internet.

     Para criar um ponto final privado, você precisa acessar uma rede virtual na nuvem (VCN) com uma sub-rede privada. Selecione uma VCN com uma sub-rede privada na qual a resolução de DNS também esteja ativada e, em seguida, selecione a sub-rede.

     Se, em vez disso, quiser designar um endereço IP privado específico, você deverá selecionar um que pertence ao CIDR da sub-rede. Por padrão, o serviço Networking atribui um endereço IP privado randomizado em seu nome e aplica regras de segurança ao stream pool. Para obter mais informações, consulte Gerenciamento de VCN e Sub-rede.

     Você também pode selecionar um grupo de segurança de rede existente para aplicar o mesmo conjunto de regras de segurança a cada fluxo do pool.

  5. Em Configurar Definições de Criptografia, selecione como criptografar os streams no pool de streams.

     Por padrão, a opção Criptografar usando chaves gerenciadas pela Oracle é selecionada. Para criptografar os dados neste pool de streams usando sua própria chave de criptografia do serviço Vault, selecione Criptografar usando chaves gerenciadas pelo cliente. Para usar o serviço Vault, 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.

  6. Para adicionar tags ou se você pretende usar o Kafka com esse pool de streams, selecione Mostrar Opções Avançadas.
  7. (Opcional) Designe tags ao pool de streams. 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.
  8. Para usar o pool de streams com o Kafka, selecione Criar tópicos automaticamente e configure suas definições de stream:
     • Período de Retenção Padrão (Horas): Especifique o número de horas do 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.
     • Selecione Exibir definições do Kafka após a criação do pool de Streams para exibir as definições de Conexão do Kafka para o pool de streams após sua criação.
  9. (Opcional) Adicione uma ou mais tags ao pool de streams: Selecione Mostrar Opções Avançadas para mostrar a seção Adicionar 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ê deve 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 essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.
  10. Selecione Criar.

• Use o comando oci streaming admin stream-pool create e os parâmetros necessários para criar um pool de fluxos:

  oci streaming admin stream-pool create --name <stream_pool_name> --compartment-id <compartment_OCID>

  Por exemplo:

  oci streaming admin stream-pool create --name MyStreamPool --compartment-id ocid1.tenancy.oc1..exampleuniqueID
  {
    "data": {
      "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
      "custom-encryption-key": {
        "key-state": "NONE",
        "kms-key-id": null
      },
      "defined-tags": {},
      "endpoint-fqdn": null,
      "freeform-tags": {},
      "id": "ocid1.streampool.oc1.phx.exampleuniqueID",
      "is-private": false,
      "kafka-settings": {
        "auto-create-topics-enable": false,
        "bootstrap-servers": null,
        "log-retention-hours": 24,
        "num-partitions": 1
      },
      "lifecycle-state": "CREATING",
      "lifecycle-state-details": null,
      "name": "MyStreamPool",
      "private-endpoint-settings": {
        "nsg-ids": null,
        "private-endpoint-ip": null,
        "subnet-id": null
      },
      "time-created": "2020-11-02T23:01:59.429000+00:00"
    },
    "etag": "\"b0066564-4bf4-4e27-9255-9055e69a7808-03668273-b0d5-4b8b-9370-74522c29eb56\""
  }

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

• Use a operação de API CreateStreamPool para criar um pool de streams.

resource "oci_streaming_stream_pool" "test_stream_pool" {
  #Required
  compartment_id = var.compartment_ocid
  name           = "<stream_pool_name>"

  #Optional
  private_endpoint_settings {
    nsg_ids             = [oci_core_network_security_group.test_nsg.id]
    private_endpoint_ip = "10.0.0.5"
    subnet_id           = oci_core_subnet.test_subnet.id
  }

  kafka_settings {
    #Optional
    auto_create_topics_enable = true
    log_retention_hours       = 24
    num_partitions            = 1
  }
}

resource "oci_core_vcn" "test_vcn" {
  cidr_block     = "10.0.0.0/16"
  compartment_id = var.compartment_ocid
  display_name   = "testvcn"
  dns_label      = "dnslabel"
}

resource "oci_core_subnet" "test_subnet" {
  cidr_block     = "10.0.0.0/24"
  compartment_id = var.compartment_ocid
  vcn_id         = oci_core_vcn.test_vcn.id
}

resource "oci_core_network_security_group" "test_nsg" {
  compartment_id = var.compartment_ocid
  vcn_id         = oci_core_vcn.test_vcn.id
}