Creación de un clúster de Amazon MSK aprovisionado mediante la AWS CLI

1. Copie el siguiente JSON y guárdelo en un archivo. Asigne el nombre al archivo brokernodegroupinfo.json. Reemplace los ID de subred en el archivo JSON con los valores que corresponden a las subredes. Estas subredes deben estar en diferentes zonas de disponibilidad. Reemplace «Security-Group-ID» con el ID de uno o más grupos de seguridad de la VPC del cliente. Los clientes asociados a estos grupos de seguridad obtienen acceso al clúster. Si especifica grupos de seguridad que se han compartido con usted, debe asegurarse de que tiene permisos para ellos. En concreto, necesita el permiso ec2:DescribeSecurityGroups. Para ver un ejemplo, consulte Amazon EC2: permite administrar grupos de seguridad de Amazon EC2 asociados con una VPC específica, mediante programación y en la consola. Finalmente, guarde el archivo JSON actualizado en el equipo donde tiene instalado el archivo AWS CLI.

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

   importante

   Para agentes Express, necesita tres subredes en tres zonas de disponibilidad diferentes. Tampoco necesita definir ninguna propiedad relacionada con el almacenamiento.

   Para agentes Standard en la región Oeste de EE: UU. (Norte de California), necesita dos subredes en dos zonas de disponibilidad diferentes. En el resto de las regiones donde esté disponible Amazon MSK, puede especificar dos o tres subredes. Todas las subredes deben estar en diferentes zonas de disponibilidad. Al crear un clúster, Amazon MSK distribuye los nodos del agente de manera uniforme a través de las subredes que indique.

2. Ejecute el siguiente comando AWS CLI en el directorio donde guardó el archivo brokernodegroupinfo.json, reemplazando «Your-Cluster-Name» con un nombre de su elección. Para «Monitoring-level», puede especificar uno de los tres valores siguientes: DEFAULT, PER_BROKER, o PER_TOPIC_PER_BROKER. Para obtener información sobre estos tres niveles diferentes de supervisión, consulte Supervisión de un clúster de Amazon MSK aprovisionado. El parámetro enhanced-monitoring es opcional. Si no lo especifica en el comando create-cluster, obtendrá el nivel de supervisión DEFAULT.

   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"

   El resultado del comando tendrá un aspecto similar al siguiente JSON:

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

   nota

   El comando create-cluster puede devolver un error que indica que una o más subredes pertenecen a zonas de disponibilidad no compatibles. Cuando esto sucede, el error indica qué zonas de disponibilidad no son compatibles. Cree subredes que no utilicen las zonas de disponibilidad no admitidas e intente ejecutar el comando create-cluster de nuevo.

3. Guarde el valor de la clave ClusterArn, ya que lo necesitará para realizar otras acciones en el clúster.

4. Ejecute el siguiente comando para comprobar el STATE del clúster. El valor de STATE cambia de CREATING a ACTIVE a medida que Amazon MSK aprovisiona el clúster. Cuando el estado sea ACTIVE, podrá conectarse al clúster. Para obtener más información acerca del estado de un clúster, consulte Descripción de los estados de los clústeres de MSK aprovisionados.

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