Crear un pool de flujos
Cree un pool de flujos en el servicio Streaming. Un pool de flujos es una agrupación lógica para flujos.
Cada flujo debe ser miembro de un pool de flujos. Si no crea un pool de flujos o especifica un pool de flujos existente al crear un flujo, el servicio Streaming utiliza un pool por defecto para contener el flujo. Para revisar los requisitos para crear y gestionar flujos, consulte Introducción a Streaming.
Utilice el comando oci streaming admin stream-pool create y los parámetros necesarios para crear un pool de flujos:
oci streaming admin stream-pool create --name <stream_pool_name> --compartment-id <compartment_OCID>
Por ejemplo:
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\"" }
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.
Utilice la operación de API CreateStreamPool para crear un pool de flujos.
Uso de los SDK de OCI
Para crear un pool de flujos, utilice el método createStreamPool
de StreamAdminClient
.
Consulte la Guía para desarrolladores de Streaming para obtener ejemplos detallados de SDK.
Uso de Resource Manager y Terraform
Utilice el recurso oci_streaming_stream_pool
para crear un pool de flujos con una configuración de compatibilidad con Kafka y punto final privado opcional. La configuración del punto final privado necesita una VCN, una subred y un grupo de seguridad de red. En este ejemplo, la configuración de Terraform también crea esos recursos.
Por ejemplo:
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
}
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.