Documentazione di Oracle Cloud Infrastructure

Aggiornamento di un pool di flussi

Modificare le impostazioni di un pool di flussi per l'uso e la cifratura Kafka (chiave di cifratura master).

Quando si aggiorna un pool di flussi, è anche possibile aggiornarne le tag. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa.

Per esaminare i requisiti per la creazione e la gestione dei flussi, vedere Guida introduttiva allo streaming.

    1. Nella pagina di elenco Pool di flusso, selezionare il pool di flussi con cui si desidera lavorare. Per assistenza nella ricerca della pagina di elenco o del pool di flussi, vedere Elenco dei pool di flussi.
    2. Nella pagina dei dettagli selezionare Modifica impostazioni.
    3. Per utilizzare il pool di flussi con Kafka, selezionare Crea automaticamente argomenti e configurare le impostazioni del flusso:
      • Periodo di conservazione predefinito (ore): specificare un numero di ore per il periodo di conservazione del flusso.
      • Numero predefinito di partizioni: specificare il numero predefinito di partizioni per il flusso.
    4. Per cifrare i dati nei flussi di questo pool di flussi utilizzando la propria chiave di cifratura del vault, selezionare Cifra mediante chiavi gestite dal cliente. Per utilizzare il servizio Vault per le esigenze di cifratura, è necessario accedere a un vault e a una chiave e consentire al servizio di utilizzare la chiave.
      • Vault: selezionare il vault contenente la chiave di cifratura master da utilizzare.
      • Chiave di cifratura master: selezionare la chiave di cifratura master da utilizzare.

      Per ulteriori informazioni sulla cifratura con una chiave del vault gestita, vedere Panoramica del vault e Gestione delle chiavi.

      Nota

      È inoltre possibile aggiornare le impostazioni di cifratura dalla pagina dei dettagli.

      • Per interrompere l'utilizzo di una chiave gestita da Oracle a favore di una chiave di cifratura master del vault gestita, selezionare Assegna, selezionare un vault e una chiave di cifratura a cui si ha accesso, quindi selezionare Assegna.
      • Per selezionare una chiave di cifratura principale del vault diversa da gestire, selezionare Aggiorna, selezionare un vault e una chiave di cifratura a cui si ha accesso, quindi selezionare Aggiorna.
      • Per rimuovere la chiave di cifratura principale del vault assegnata e consentire a Oracle di gestire la chiave di cifratura, selezionare Annulla assegnazione, quindi selezionare di nuovo Annulla assegnazione per confermare la rimozione dell'assegnazione della chiave esistente.
    5. Selezionare Modifica impostazioni per salvare le modifiche.
    6. (Facoltativo) Aggiungere una o più tag al pool di flussi: nella pagina dei dettagli, selezionare Tag.
      Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag defined, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.

  • Utilizzare il comando oci streaming admin stream-pool update e i parametri richiesti per aggiornare un pool di flussi:

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

    Ad esempio:

    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\""
}
    Suggerimento

    Fornire l'input per --custom-encryption-key-details, --private-endpoint-details e --kafka-settings come JSON formattato valido. Per informazioni sulla formattazione JSON, vedere Passaggio dell'input complesso e Utilizzo di un file JSON per l'input complesso.

    Per un elenco completo dei parametri e dei valori per i comandi della CLI, vedere il manuale CLI Command Reference.

  • Eseguire l'operazione UpdateStreamPool per aggiornare un pool di flussi.

Uso di Resource Manager e Terraform

Aggiornare la risorsa oci_streaming_stream_pool nella configurazione Terraform e modificare lo stack oppure eseguire un job terraform apply.

Informazioni su Resource Manager e Terraform

Resource Manager è un servizio Oracle Cloud Infrastructure (OCI) che consente di automatizzare il processo di provisioning delle risorse OCI. Utilizzando Terraform, Resource Manager ti aiuta a installare, configurare e gestire le risorse attraverso il modello "infrastructure-as-code".

Una configurazione Terraform codifica l'infrastruttura nei file di configurazione dichiarativi. La configurazione definisce le risorse di cui si intende eseguire il provisioning, le variabili e le istruzioni specifiche per il provisioning delle risorse

È possibile utilizzare Resource Manager o l'interfaccia CLI Terraform con il provider OCI Terraform per vedere come i flussi e i pool di flussi sono rappresentati nei file di configurazione Terraform.

Per ulteriori informazioni sulla scrittura delle configurazioni da utilizzare con Resource Manager, vedere Configurazioni Terraform per Resource Manager e Configurazione Terraform.