View a markdown version of this page

Buat cluster Amazon MSK yang disediakan menggunakan AWS CLI - Amazon Managed Streaming untuk Apache Kafka

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Buat cluster Amazon MSK yang disediakan menggunakan AWS CLI

  1. Salin JSON berikut dan simpan ke file. Beri nama filebrokernodegroupinfo.json. Ganti ID subnet di JSON dengan nilai-nilai yang sesuai dengan subnet Anda. Subnet ini harus berada di Zona Ketersediaan yang berbeda. Ganti "Security-Group-ID" dengan ID satu atau lebih grup keamanan VPC klien. Klien yang terkait dengan grup keamanan ini mendapatkan akses ke cluster. Jika Anda menentukan grup keamanan yang dibagikan untuk Anda, Anda harus memastikan bahwa Anda memiliki izin untuknya. Secara khusus, Anda memerlukan izin ec2:DescribeSecurityGroups. Sebagai contoh, lihat Amazon EC2: Memungkinkan Mengelola Grup Keamanan Amazon EC2 yang Terkait Dengan VPC Tertentu, Secara Terprogram dan di Konsol. Terakhir, simpan file JSON yang diperbarui di komputer tempat Anda meng AWS CLI instalnya.

    {
  "InstanceType": "kafka.m5.large",
  "ClientSubnets": [
    "Subnet-1-ID",
    "Subnet-2-ID"
  ],
  "SecurityGroups": [
    "Security-Group-ID"
  ]
}
    penting

    Untuk broker Express, Anda memerlukan tiga subnet di tiga Zona Ketersediaan yang berbeda. Anda juga tidak perlu menentukan properti terkait penyimpanan apa pun.

    Untuk broker Standar di Wilayah AS Barat (California Utara), Anda memerlukan dua subnet di dua Zona Ketersediaan yang berbeda. Di semua Wilayah lain di mana Amazon MSK tersedia, Anda dapat menentukan dua atau tiga subnet. Semua subnet Anda harus berada di Zona Ketersediaan yang berbeda. Saat Anda membuat cluster, Amazon MSK mendistribusikan node broker secara merata di atas subnet yang Anda tentukan.

  2. Jalankan AWS CLI perintah berikut di direktori tempat Anda menyimpan brokernodegroupinfo.json file, ganti "Your-Cluster-Name" dengan nama pilihan Anda. Untuk"Monitoring-Level", Anda dapat menentukan salah satu dari tiga nilai berikut:DEFAULT,PER_BROKER, atauPER_TOPIC_PER_BROKER. Untuk informasi tentang tiga tingkat pemantauan yang berbeda ini, lihatMemantau cluster yang disediakan Amazon MSK. Parameter enhanced-monitoring bersifat opsional. Jika Anda tidak menentukannya dalam create-cluster perintah, Anda mendapatkan DEFAULT tingkat pemantauan.

    aws kafka create-cluster --cluster-name "Your-Cluster-Name" --broker-node-group-info file://brokernodegroupinfo.json --kafka-version "2.8.1" --number-of-broker-nodes 3 --enhanced-monitoring "Monitoring-Level"

    Output dari perintah terlihat seperti JSON berikut:

    {
    "ClusterArn": "...",
    "ClusterName": "AWSKafkaTutorialCluster",
    "State": "CREATING"
}
    catatan

    Per create-cluster intah mungkin mengembalikan kesalahan yang menyatakan bahwa satu atau lebih subnet milik Zona Ketersediaan yang tidak didukung. Ketika ini terjadi, kesalahan menunjukkan Zona Ketersediaan mana yang tidak didukung. Buat subnet yang tidak menggunakan Zona Ketersediaan yang tidak didukung dan coba create-cluster perintah lagi.

  3. Simpan nilai ClusterArn kunci karena Anda membutuhkannya untuk melakukan tindakan lain pada cluster Anda.

  4. Jalankan perintah berikut untuk memeriksa cluster AndaSTATE. STATENilai berubah dari CREATING menjadi ACTIVE saat Amazon MSK menyediakan cluster. Ketika statusnyaACTIVE, Anda dapat terhubung ke cluster. Untuk informasi selengkapnya tentang status cluster, lihatMemahami status cluster yang disediakan MSK.

    aws kafka describe-cluster --cluster-arn <your-cluster-ARN>