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.

    1. Sur la page de liste Pools de flux de données, sélectionnez Créer un pool de flux de données. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des pools de flux de données.
    2. Entrez le nom du pool de flux de données. Evitez de saisir des informations confidentielles.
    3. Sélectionnez le compartiment du pool de flux de données.
    4. Sélectionner un type d'adresse. Sélectionnez l'adresse publique ou l'adresse privée, selon que vous souhaitez ou non restreindre le trafic vers les flux de données de ce pool à une adresse privée ne nécessitant pas que le trafic passe par Internet.

      Pour créer une adresse privée, vous devez avoir accès à un réseau cloud virtuel disposant d'un sous-réseau privé. Sélectionnez un réseau cloud virtuel disposant d'un sous-réseau privé dans lequel la résolution DNS est également activée, puis sélectionnez le sous-réseau.

      Si vous souhaitez 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 Networking affecte une adresse IP privée aléatoire en votre nom et n'applique aucune règle de sécurité au pool de flux de données. Pour plus d'informations, reportez-vous à la section VCN and Subnet Management.

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

    5. Sous Configurer les paramètres de cryptage, sélectionnez le mode de cryptage des flux de données dans le pool de flux de données.

      Par défaut, l'option Crypter à l'aide des clés gérées par Oracle est sélectionnée. Pour crypter les données des flux de ce pool à l'aide de votre propre clé de cryptage Vault, sélectionnez Crypter à l'aide des clés gérées par le client. Pour utiliser le service Vault, vous devez avoir accès à un coffre et à une clé, et autoriser le service à utiliser la clé.

      • Coffre : sélectionnez le coffre qui contient la clé de cryptage maître à utiliser.
      • Clé de cryptage maître : sélectionnez la clé de cryptage maître à utiliser.

      Pour plus d'informations sur le cryptage avec une clé Vault que vous gérez, reportez-vous à Présentation de Vault et à Gestion des clés.

    6. Pour ajouter des balises ou si vous prévoyez d'utiliser Kafka avec ce pool de flux de données, sélectionnez Afficher les options avancées.
    7. (Facultatif) Affectez des balises au pool de flux de données. Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à forme libre. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    8. Pour utiliser le pool de flux de données avec Kafka, sélectionnez Créer automatiquement des sujets et configurez les paramètres de flux de données :
      • Période de conservation par défaut (heures) : indiquez le nombre d'heures de la période de conservation du flux de données.
      • Nombre de partitions par défaut : indiquez le nombre de partitions par défaut pour le flux.
      • Sélectionnez Afficher les paramètres Kafka une fois le pool de flux de données créé pour afficher les paramètres de connexion Kafka du pool de flux de données une fois celui-ci créé.
    9. (Facultatif) Ajoutez des balises au pool de flux de données : sélectionnez Afficher les options avancées pour afficher la section Ajouter des balises.
      Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous pouvez également lui appliquer des balises à forme libre. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    10. Sélectionnez Créer.
  • 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
}
A propos de Resource Manager et de Terraform

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.