Creazione di un pool di flussi
Creare un pool di flussi nel servizio di streaming. Un pool di flussi è un raggruppamento logico per i flussi.
Ogni flusso deve essere membro di un pool di flussi. Se non si crea un pool di flussi o non si specifica un pool di flussi esistente durante la creazione di un flusso, il servizio di streaming utilizza un pool predefinito per contenere il flusso. Per esaminare i requisiti per la creazione e la gestione dei flussi, vedere Guida introduttiva allo streaming.
Utilizzare il comando oci streaming admin stream-pool create e i parametri richiesti per creare un pool di flussi:
oci streaming admin stream-pool create --name <stream_pool_name> --compartment-id <compartment_OCID>
Ad esempio:
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\"" }
Suggerimento
Fornire l'input per--custom-encryption-key-details
,--private-endpoint-details
e--kafka-settings
come JSON formattato valido. Per informazioni sulla formattazione JSON, vedere Passaggio dell'input complesso e Utilizzo di un file JSON per l'input complesso.Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.
Utilizzare l'operazione API CreateStreamPool per creare un pool di flussi.
Uso degli SDK OCI
Per creare un pool di flussi, utilizzare il metodo createStreamPool
di StreamAdminClient
.
Per esempi dettagliati sull'SDK, consulta la Guida per gli sviluppatori allo streaming.
Uso di Resource Manager e Terraform
Utilizzare la risorsa oci_streaming_stream_pool
per creare un pool di flussi con impostazioni facoltative di endpoint privato e compatibilità Kafka. Le impostazioni dell'endpoint privato richiedono una VCN, una subnet e un gruppo di sicurezza di rete. In questo esempio, la configurazione Terraform crea anche tali risorse.
Ad esempio:
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 è un servizio Oracle Cloud Infrastructure (OCI) che consente di automatizzare il processo di provisioning delle risorse OCI. Utilizzando Terraform, Resource Manager ti aiuta a installare, configurare e gestire le risorse attraverso il modello "infrastructure-as-code".
Una configurazione Terraform codifica l'infrastruttura nei file di configurazione dichiarativi. La configurazione definisce le risorse di cui si intende eseguire il provisioning, le variabili e le istruzioni specifiche per il provisioning delle risorse
È possibile utilizzare Resource Manager o l'interfaccia CLI Terraform con il provider OCI Terraform per vedere come i flussi e i pool di flussi sono rappresentati nei file di configurazione Terraform.
Per ulteriori informazioni sulla scrittura delle configurazioni da utilizzare con Resource Manager, vedere Configurazioni Terraform per Resource Manager e Configurazione Terraform.