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.

    1. Dans la page de liste Groupes de flux, sélectionnez Créer un groupe de flux. Si vous avez besoin d'aide pour trouver la page de liste, voir Liste des groupes de flux.
    2. Entrez un nom pour le groupe de flux. Évitez d'entrer des informations confidentielles.
    3. Sélectionnez le compartiment pour le groupe de flux.
    4. Sélectionner le type de point d'extrémité. Sélectionnez Point d'extrémité public ou Point d'extrémité privé, selon que vous voulez limiter le trafic aux flux de ce groupe à un point d'extrémité privé qui ne nécessite pas de trafic passant par Internet.

      Pour créer un point d'extrémité privé, vous devez avoir accès à un réseau en nuage virtuel (VCN) avec un sous-réseau privé. Sélectionnez un réseau VCN avec un sous-réseau privé où la résolution DNS est activée, puis sélectionnez le sous-réseau.

      Si vous voulez plutôt affecter une adresse IP privée spécifique, vous devez en sélectionner une qui appartient au CIDR du sous-réseau. Par défaut, le service de réseau affecte une adresse IP privée aléatoire en votre nom et n'applique aucune règle de sécurité au groupe de flux. Pour plus d'informations, voir VCN et gestion de sous-réseau.

      Vous pouvez également sélectionner un groupe de sécurité de réseau existant pour appliquer le même jeu de règles de sécurité à chaque flux du groupe.

    5. Sous Configurer les paramètres de chiffrement, sélectionnez comment chiffrer les flux du groupe de flux.

      Par défaut, l'option Chiffrer à l'aide des clés gérées par Oracle est sélectionnée. Pour chiffrer les données des flux de ce groupe à l'aide de votre propre clé de chiffrement du service de chambre forte, sélectionnez Chiffrer à l'aide des clés gérées par le client. Pour utiliser le service de chambre forte, vous devez avoir accès à une chambre forte et à une clé, et vous devez autoriser le service à utiliser la clé.

      • Chambre forte : Sélectionnez la chambre forte qui contient la clé de chiffrement principale à utiliser.
      • Clé de chiffrement principale : Sélectionnez la clé de chiffrement principale à utiliser.

      Pour plus d'informations sur le chiffrement avec une clé de chambre forte que vous gérez, voir Aperçu du service de chambre forte et Gestion des clés.

    6. Pour ajouter des marqueurs ou si vous avez l'intention d'utiliser Kafka avec ce groupe de flux, sélectionnez Afficher les options avancées.
    7. (Facultatif) Affectez des marqueurs au groupe de flux. Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    8. Pour utiliser le groupe de flux avec Kafka, sélectionnez Créer automatiquement des rubriques et configurer vos paramètres de flux :
      • Période de conservation (en heures) : Spécifiez le nombre d'heures pour la période de conservation du flux.
      • Nombre de partitions par défaut : Spécifiez le nombre de partitions par défaut pour le flux.
      • Sélectionnez Voir les paramètres Kafka après la création du groupe de flux pour afficher les paramètres de connexion Kafka pour le groupe de flux après sa création.
    9. (Facultatif) Ajoutez un ou plusieurs marqueurs au groupe de flux : Sélectionnez Afficher les options avancées pour afficher la section Ajouter des marqueurs.
      Si vous avez l'autorisation de créer une ressource, vous avez également l'autorisation d'appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
    10. Sélectionnez Créer.
  • 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 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
}
À propos du gestionnaire de ressources et de Terraform

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.