Création d'un groupe de flux
Créez un groupe de flux dans le service de diffusion en continu. Un groupe de flux est un regroupement logique pour les flux.
Chaque flux doit être membre d'un groupe de flux. Si vous ne créez pas de groupe de flux ou ne spécifiez pas de groupe de flux existant lors de la création d'un flux, le service de diffusion en continu utilise un groupe par défaut pour contenir le flux. Pour connaître les exigences relatives à la création et à la gestion des flux, voir Introduction au service de diffusion en continu.
Utilisez la commande oci streaming admin stream-pool create et les paramètres requis pour créer un groupe de flux :
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. Voir Transmission d'entrée complexe et Utilisation d'un fichier JSON pour une entrée complexe pour plus d'informations sur le formatage JSON.Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir .
Utilisez l'opération d'API CreateStreamPool pour créer un groupe de flux.
Utilisation des trousses SDK pour OCI
Pour créer un groupe de flux, utilisez la méthode createStreamPool
de StreamAdminClient
.
Pour obtenir des exemples détaillés de trousse SDK, consultez le guide du développeur pour le service de diffusion en continu.
Utilisation du gestionnaire de ressources et de Terraform
Utilisez la ressource oci_streaming_stream_pool
pour créer un groupe de flux avec des paramètres facultatifs de point d'extrémité privé et de compatibilité Kafka. Les paramètres de point d'extrémité privé requièrent un réseau en nuage virtuel, un sous-réseau et un groupe de sécurité de 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
}
Le gestionnaire de ressources est un service pour Oracle Cloud Infrastructure (OCI) qui vous permet d'automatiser le processus de provisionnement des ressources OCI. À l'aide de Terraform, le gestionnaire de ressources vous aide à installer, configurer et gérer des ressources selon le modèle "infrastructure-code".
Une configuration Terraform code l'infrastructure dans des fichiers de configuration déclaratifs. La configuration définit les ressources que vous prévoyez de provisionner, des variables et des instructions spécifiques pour le provisionnement des ressources.
Vous pouvez utiliser le gestionnaire de ressources ou l'interface de ligne de commande Terraform avec le fournisseur Terraform pour pour voir comment les flux et les groupes de flux sont représentés dans des fichiers de configuration Terraform.
Pour plus d'informations sur l'écriture de configurations à utiliser avec le gestionnaire de ressources, voir Configurations Terraform pour le gestionnaire de ressources et Configuration Terraform.