Yandex.Cloud
  • Services
  • Why Yandex.Cloud
  • Pricing
  • Documentation
  • Contact us
Get started
Yandex Managed Service for Apache Kafka®
  • Getting started
  • Step-by-step instructions
    • All instructions
    • Information about existing clusters
    • Creating clusters
    • Connecting to clusters
    • Stopping and starting clusters
    • Changing cluster settings
    • Working with topics and partitions
    • Managing Kafka accounts
    • Deleting clusters
  • Concepts
    • Relationship between service resources
    • Topics and partitions
    • Brokers
    • Producers and consumers
    • Host classes
    • Network in Managed Service for Apache Kafka®
    • Quotas and limits
    • Storage types
  • Access management
  • Pricing policy
  • API reference
    • Authentication in the API
    • gRPC
      • Overview
      • ClusterService
      • ResourcePresetService
      • TopicService
      • UserService
      • OperationService
    • REST
      • Overview
      • Cluster
        • Overview
        • create
        • delete
        • get
        • list
        • listHosts
        • listLogs
        • listOperations
        • move
        • start
        • stop
        • streamLogs
        • update
      • ResourcePreset
        • Overview
        • get
        • list
      • Topic
        • Overview
        • create
        • delete
        • get
        • list
        • update
      • User
        • Overview
        • create
        • delete
        • get
        • grantPermission
        • list
        • revokePermission
        • update
      • Operation
        • Overview
        • get
  • Questions and answers
  1. Step-by-step instructions
  2. Creating clusters

Creating clusters

    A cluster in Managed Service for Apache Kafka® is one or more broker hosts where topics and their partitions are located. Producers and consumers can work with these topics by connecting to cluster hosts.

    Warning

    If you create a cluster with more than one host, three dedicated ZooKeeper hosts will be added to the cluster. For more information, see Relationship between service resources.

    Management console
    API

    To create a cluster, follow these steps:

    1. In the management console, select the folder where you want to create a cluster.

    2. Select Managed Service for Apache Kafka®.

    3. Click Create cluster.

    4. Under Basic parameters:

      1. Enter a name for the cluster and, if necessary, a description. The cluster name must be unique within the folder.
      2. Select the environment where you want to create the cluster (you can't change the environment once the cluster is created):
        • PRODUCTION: For stable versions of your apps.
        • PRESTABLE: For testing, including the Managed Service for Apache Kafka® service itself. The Prestable environment is first updated with new features, improvements, and bug fixes. However, not every update ensures backward compatibility.
      3. Select the Apache Kafka® version.
    5. Under Host class, select the platform, host type, and host class.

      The host class defines the technical specifications of the VMs where the Apache Kafka® brokers will be deployed. All available options are listed in Host classes.

      When you change the host class for the cluster, the characteristics of all existing instances change.

    6. Under Storage:

      1. Choose the type of storage, either a more flexible network type (network-hdd or network-ssd) or faster local SSD storage (local-ssd).
      2. Select the size of storage to be used for data. The size of the local storage can only be changed in 100 GB increments.
    7. Under Network settings:

      1. Select one or more availability zones where the Apache Kafka® brokers will reside.

      2. Select the network.

      3. Select subnets in each availability zone for this network. To create a new subnet, click Create new subnet next to the desired availability zone.

        Note

        For a cluster with multiple broker hosts, you need to specify subnets in each availability zone even if you plan to host brokers only in some of them. These subnets are required to host three ZooKeeper hosts — one in each availability zone. For more information, see Relationship between service resources.

      4. To access broker hosts from the internet, select Public access. In this case, you can only connect to them over an SSL connection. For more information, see Connecting to topics in an Apache Kafka® cluster.

        Warning

        You can't request public access after creating a cluster.

    8. Under Hosts, specify the number of broker hosts Apache Kafka® to be located in each of the selected availability zones.

      When choosing the number of hosts, keep in mind that:

      • The Apache Kafka® cluster hosts will be evenly deployed in the selected availability zones. Decide on the number of zones and hosts per zone based on the required fault tolerance model and cluster load.
      • Replication is possible if there are at least two hosts in the cluster.
      • Adding more than one host to the cluster automatically adds three ZooKeeper hosts.
    9. If you specify two or more broker hosts, under Host class ZooKeeper, specify the characteristics of the hostsZooKeeper to be located in each of the selected availability zones.

    10. Click Create cluster.

    11. Wait until the cluster is ready: its status on the Managed Service for Apache Kafka® dashboard changes to Running and its state to Alive. This may take some time.

    To create a cluster, use the create API method and pass the following in the request:

    • In the folderId parameter, the ID of the folder where the cluster should be placed.
    • The cluster name in the name parameter.
    Language
    Careers
    Privacy policy
    Terms of use
    © 2021 Yandex.Cloud LLC