Création d'un pool de flux de données
Créez un pool de flux de données dans le service Streaming. Un pool de flux de données est un regroupement logique pour les flux de données.
Chaque flux de données doit être membre d'un pool de flux de données. Si vous ne créez pas de pool de flux de données ou n'indiquez pas de pool de flux de données existant lors de la création d'un flux de données, le service Streaming utilise un pool par défaut pour contenir le flux de données. Pour consulter les exigences relatives à la création et à la gestion des flux de données, reportez-vous à Introduction à Streaming.
Utilisez la commande oci streaming admin stream-pool create et les paramètres requis pour créer un pool de flux de données :
oci streaming admin stream-pool create --name <stream_pool_name> --compartment-id <compartment_OCID>
Par exemple :
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\"" }
Conseil
Indiquez une entrée pour--custom-encryption-key-details
,--private-endpoint-details
et--kafka-settings
dans un format JSON valide. Pour plus d'informations sur le formatage JSON, reportez-vous à Transmission d'une entrée complexe et à Utilisation d'un fichier JSON pour une entrée complexe.Pour obtenir la liste complète des paramètres et valeurs des commandes de la CLI, reportez-vous à la référence des commandes de la CLI.
Utilisez l'opération d'API CreateStreamPool pour créer un pool de flux de données.
Utilisation des kits SDK OCI
Pour créer un pool de flux de données, utilisez la méthode createStreamPool
de StreamAdminClient
.
Reportez-vous au guide du développeur pour Streaming afin d'obtenir des exemples de kit SDK détaillés.
Utilisation de Resource Manager et de Terraform
Utilisez la ressource oci_streaming_stream_pool
pour créer un pool de flux de données avec des paramètres facultatifs d'adresse privée et de compatibilité Kafka. Les paramètres d'adresse privée nécessitent un réseau cloud virtuel, un sous-réseau et un groupe de sécurité réseau. Cet exemple de configuration Terraform crée également ces ressources.
Par exemple :
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 est un service Oracle Cloud Infrastructure (OCI) qui permet d'automatiser le processus de provisionnement de vos ressources OCI. Avec Terraform, Resource Manager vous aide à installer, à configurer et à gérer des ressources via le modèle "infrastructure-as-code".
Une configuration Terraform codifie votre infrastructure dans les fichiers de configuration déclaratifs. La configuration définit les ressources que vous prévoyez de provisionner, les variables et les instructions spécifiques pour le provisionnement des ressources.
Vous pouvez utiliser Resource Manager ou l'interface de ligne de commande Terraform avec le fournisseur OCI Terraform pour voir comment les flux de données et les pools de flux de données sont représentés dans les fichiers de configuration Terraform.
Pour plus d'informations sur l'écriture de configurations à utiliser avec Resource Manager, reportez-vous à Configurations Terraform pour Resource Manager et à Configuration de Terraform.