Streampool erstellen

• Konsole
• CLI
• API

• 1. Wählen Sie auf der Listenseite Streampools die Option Streampool erstellen aus. Wenn Sie Hilfe beim Suchen der Listenseite benötigen, finden Sie weitere Informationen unter Streampools auflisten.
  2. Geben Sie einen Namen für den Streampool ein. Geben Sie dabei keine vertraulichen Informationen ein.
  3. Wählen Sie das Compartment für den Streampool aus.
  4. Endpunkttyp auswählen. Wählen Sie Public Endpoint oder Private Endpoint aus, abhängig davon, ob Sie den Datenverkehr zu den Datenströmen in diesem Datenstrompool auf einen privaten Endpunkt beschränken möchten, für den der Datenverkehr nicht über das Internet geführt werden muss.

     Um einen privaten Endpunkt zu erstellen, benötigen Sie Zugriff auf ein virtuelles Cloud-Netzwerk (VCN) mit einem privaten Subnetz. Wählen Sie ein VCN mit einem privaten Subnetz aus, in dem DNS-Auflösung ebenfalls aktiviert ist, und wählen Sie dann das Subnetz aus.

     Wenn Sie stattdessen eine bestimmte private IP-Adresse zuweisen möchten, müssen Sie eine IP-Adresse auswählen, die zum CIDR des Subnetzes gehört. Standardmäßig weist Ihnen der Networking Service eine zufällige private IP-Adresse zu und wendet keine Sicherheitsregeln auf den Streampool an. Weitere Informationen finden Sie unter VCN- und Subnetzverwaltung.

     Sie können auch eine vorhandene Netzwerksicherheitsgruppe auswählen, um für jeden Stream im Pool dieselben Sicherheitsregeln anzuwenden.

  5. Wählen Sie unter Verschlüsselungseinstellungen konfigurieren aus, wie die Streams im Streampool verschlüsselt werden sollen.

     Standardmäßig ist Mit von Oracle verwalteten Schlüsseln verschlüsseln ausgewählt. Um die Daten in den Streams in diesem Streampool mit Ihrem eigenen Vault-Verschlüsselungsschlüssel zu verschlüsseln, wählen Sie Mit vom Kunden verwalteten Schlüsseln verschlüsseln aus. Um den Vault-Service zu verwenden, benötigen Sie Zugriff auf einen Vault und einen Schlüssel, und Sie müssen dem Service die Verwendung des Schlüssels ermöglichen.

     • Vault: Wählen Sie den Vault aus, der den zu verwendenden Masterverschlüsselungsschlüssel enthält.
     • Master-Verschlüsselungsschlüssel: Wählen Sie den zu verwendenden Master-Verschlüsselungsschlüssel aus.

     Weitere Informationen zur Verschlüsselung mit einem Vault-Schlüssel, den Sie verwalten, finden Sie unter Überblick über Vault und Schlüssel verwalten.

  6. Um Tags hinzuzufügen oder wenn Sie Kafka mit diesem Streampool verwenden möchten, wählen Sie Erweiterte Optionen anzeigen aus.
  7. (Optional) Weisen Sie dem Streampool Tags zu. Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
  8. Um den Streampool mit Kafka zu verwenden, wählen Sie Topics automatisch erstellen aus, und konfigurieren Sie die Streameinstellungen:
     • Standardaufbewahrungszeitraum (Stunden): Geben Sie die Anzahl der Stunden für den Aufbewahrungszeitraum des Streams an.
     • Standardanzahl Partitionen: Geben Sie die Standardanzahl Partitionen für den Stream an.
     • Wählen Sie Kafka-Einstellungen nach dem Erstellen des Streampools anzeigen aus, um die Kafka-Verbindungseinstellungen für den Streampool nach der Erstellung anzuzeigen.
  9. (Optional) Fügen Sie dem Streampool mindestens ein Tag hinzu: Wählen Sie Erweiterte Optionen anzeigen aus, um den Abschnitt Tags hinzufügen anzuzeigen.
     Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
  10. Klicken Sie auf Erstellen.

• Verwenden Sie den Befehl oci streaming admin stream-pool create und die erforderlichen Parameter, um einen Streampool zu erstellen:

  oci streaming admin stream-pool create --name <stream_pool_name> --compartment-id <compartment_OCID>

  Beispiel:

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

  Tipp
  
  Geben Sie die Eingabe für --custom-encryption-key-details, --private-endpoint-details und --kafka-settings als gültige formatierte JSON an. Informationen zur JSON-Formatierung finden Sie unter Komplexe Eingaben übergeben und JSON-Datei für komplexe Eingaben verwenden.

  Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.

• Mit dem API-Vorgang CreateStreamPool können Sie einen Streampool erstellen.

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
}