Documentation Oracle Cloud Infrastructure

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 les éléments suivants :

Pour vérifier les exigences de création et de gestion des flux de données, reportez-vous à Introduction à Streaming.

    1. Sur la page de liste Pool de flux de données, sélectionnez le pool de flux de données à utiliser. Si vous avez besoin d'aide pour trouver 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 rétention 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 du flux de données.
    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 compartiment contenant le coffre avec la clé du cryptage maître à utiliser, puis sélectionnez le coffre.
      • Clés de cryptage maître : sélectionnez le compartiment contenant la clé de cryptage maître à utiliser, puis sélectionnez la clé.

      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.

  • 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 des valeurs des commandes de la CLI, reportez-vous à 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.