Mise à jour d'un pool de flux de données

Modifier les paramètres d'un pool de flux de données pour l'utilisation et le cryptage Kafka (clé de cryptage maître).

Lorsque vous mettez à jour un pool de flux de données, vous pouvez également mettre à jour ses balises. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource.

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 le pool de flux de données à utiliser. Si vous avez besoin d'aide pour rechercher la page de liste ou le pool de flux de données, reportez-vous à Liste des pools de flux de données.
    2. Sur la page de détails, sélectionnez Modifier les paramètres.
    3. 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 un nombre d'heures pour 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.
    4. 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. Afin d'utiliser le service Vault pour vos besoins en matière de cryptage, 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.

      Remarque

      Vous pouvez également mettre à jour les paramètres de cryptage à partir de la page de détails.

      • Pour arrêter d'utiliser une clé gérée par Oracle en faveur d'une clé de cryptage maître Vault gérée par vous-même, sélectionnez Affecter, sélectionnez un coffre et une clé de cryptage auxquels vous avez accès, puis Affecter.
      • Pour sélectionner une autre clé de cryptage maître Vault gérée par vous-même, sélectionnez Mettre à jour, sélectionnez un coffre et une clé de cryptage auxquels vous avez accès, puis sélectionnez Mettre à jour.
      • Pour enlever la clé de cryptage maître Vault affectée et permettre à Oracle de gérer la clé de cryptage, sélectionnez Annuler l'affectation, puis sélectionnez à nouveau Annuler l'affectation afin de confirmer la suppression de l'affectation de clé existante.
    5. Sélectionnez Modifier les paramètres pour enregistrer les modifications.
    6. (Facultatif) Ajoutez des balises au pool de flux de données : sur la page de détails, sélectionnez 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.
  • Utilisez la commande oci streaming admin stream-pool update et les paramètres requis pour mettre à jour un pool de flux de données :

    oci streaming admin stream-pool update --stream-pool-id <stream_pool_OCID>

    Par exemple :

    oci streaming admin stream-pool update --stream-pool-id ocid1.streampool.oc1.phx.exampleuniqueID --name MyUpdatedStreamPool
    {
      "data": {
        "compartment-id": "ocid1.tenancy.oc1..exampleuniqueID",
        "custom-encryption-key": {
          "key-state": "NONE",
          "kms-key-id": null
        },
        "defined-tags": {},
        "endpoint-fqdn": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com",
        "freeform-tags": {},
        "id": "ocid1.streampool.oc1.phx.exampleuniqueID",
        "is-private": false,
        "kafka-settings": {
          "auto-create-topics-enable": false,
          "bootstrap-servers": "cell-1.streaming.us-phoenix-1.oci.oraclecloud.com:9092",
          "log-retention-hours": 24,
          "num-partitions": 1
        },
        "lifecycle-state": "UPDATING",
        "lifecycle-state-details": null,
        "name": "MyUpdatedStreamPool",
        "private-endpoint-settings": {
          "nsg-ids": null,
          "private-endpoint-ip": null,
          "subnet-id": null
        },
        "time-created": "2020-11-02T23:01:59.429000+00:00"
      },
      "etag": "\"6ad44a83-4804-4cb5-87ae-2100d3a7012c-9679fcb9-37b7-48c5-9114-d514f132d363\""
    }
    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.

  • Exécutez l'opération UpdateStreamPool pour mettre à jour un pool de flux de données.

Utilisation de Resource Manager et de Terraform

Mettez à jour la ressource oci_streaming_stream_pool dans la configuration Terraform et modifiez votre pile ou exécutez un travail terraform apply.

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.