Crear un nodo maestro de Puppet Enterprise

Inicie sesión en la AWS OpsWorks consola AWS Management Console y ábrala en https://console.aws.amazon.com/opsworks/.

En la página de AWS OpsWorks inicio, selecciona Ir a OpsWorks para Puppet Enterprise.

En la página principal OpsWorks de Puppet Enterprise, elija Crear servidor de Puppet Enterprise.

En la página Set name, region, and type (Establecer nombre, región y tipo), especifique un nombre para su servidor. Los nombres de nodo maestro de Puppet pueden tener un máximo de 40 caracteres, deben empezar por una letra y solo pueden contener caracteres alfanuméricos y guiones. Seleccione una región compatible y, a continuación, elija un tipo de instancia que admita el número de nodos que desee gestionar. Puede cambiar el tipo de instancia después de haber creado su servidor, si fuera necesario. En este tutorial, vamos a crear un tipo de instancia m5.large en la región de Oeste de EE. UU. (Oregón). Elija Siguiente.

En la página Configure server (Configurar servidor), deje la selección predeterminada en la lista desplegable SSH key (Clave SSH), a menos que desee especificar el nombre de un par de claves. En el campo r10k remote del área Configure Puppet Code Manager, especifique una URL de SSH o HTTPS válida de su Git remoto. En el campo de clave privada r10k, pega la clave privada SSH que AWS OpsWorks puedes usar para acceder al repositorio remoto r10k. Este es un servicio proporcionado por Git al crear un repositorio privado, pero no es obligatorio si utiliza la autenticación HTTPS para acceder a su repositorio de control. Elija Siguiente.

En Specify server endpoint (Especificar un punto de enlace de servidor), deje el valor predeterminado, Use an automatically-generated endpoint (Usar un punto de enlace generado automáticamente) y, a continuación, elija Next (Siguiente), a menos que desee que su servidor se encuentre en un dominio personalizado propio. Para configurar un dominio personalizado, vaya al paso siguiente.

Para utilizar un dominio personalizado, para Specify server endpoint (Especificar punto de enlace de servidor), seleccione Use a custom domain (Utilizar un dominio personalizado) en la lista desplegable.

1. En Fully qualified domain name (FQDN) (Nombre de dominio completo (FQDN)), especifique un FQDN. Debe poseer el nombre de dominio que desea utilizar.

2. En SSL certificate (Certificado SSL), pegue todo el certificado completo con formato PEM, empezando por –––--BEGIN CERTIFICATE----- y terminando por –––--END CERTIFICATE-----. El sujeto del certificado SSL debe coincidir con el FQDN especificado en el paso anterior. Elimine las líneas adicionales antes y después del certificado.

3. En SSL private key (Clave privada SSL), pegue la clave privada RSA completa, empezando por –––--BEGIN RSA PRIVATE KEY----- y terminando por –––--END RSA PRIVATE KEY-----. La clave privada SSL debe coincidir con la clave pública del certificado SSL que especificó en el paso anterior. Elimine las líneas adicionales antes y después de la clave privada. Elija Siguiente.

En la página Configurar opciones avanzadas, en el área Red y seguridad, elija una VPC, una subred y uno o más grupos de seguridad. AWS OpsWorks puede generarle un grupo de seguridad, un rol de servicio y un perfil de instancia, si aún no tiene ninguno que desee usar. El servidor puede ser un miembro de varios grupos de seguridad. Tras abandonar esta página, ya no podrá cambiar los ajustes de red y de seguridad del nodo maestro de Puppet.

En la sección System maintenance (Mantenimiento del sistema), defina el día y la hora en los que desee comenzar con el mantenimiento del sistema. Puesto que lo normal es que el servidor quede sin conexión durante las operaciones de mantenimiento del sistema, elija un momento en el horario laboral de baja demanda del servidor.

Es preciso contar con un período de mantenimiento. Puede cambiar el día y la hora de inicio más adelante mediante las API AWS Management Console AWS CLI, o las API.

Configure copias de seguridad. Las copias de seguridad automáticas están habilitadas de forma predeterminada. Establezca una frecuencia y una hora en la que se prefiera iniciar las copias de seguridad automáticas y establezca el número de copias de seguridad generadas que almacenar en Amazon Simple Storage Service. Se puede guardar un máximo de 30 copias de seguridad; cuando se alcanza el máximo, OpsWorks Puppet Enterprise elimina las copias de seguridad más antiguas para dejar espacio a las nuevas.

(Opcional) En Tags (Etiquetas), agregue etiquetas al servidor y recursos relacionados, como la instancia EC2, la dirección IP elástica, el grupo de seguridad, el bucket de S3 y las copias de seguridad. Para obtener más información sobre cómo etiquetar un OpsWorks servidor de Puppet Enterprise, consulte. Trabajar con etiquetas en AWS OpsWorks for Puppet Enterprise los recursos

Cuando haya terminado con la configuración avanzada, elija Next (Siguiente).

En la página Review (Revisar), revise las opciones seleccionadas. Cuando esté listo para crear el servidor, elija Launch (Lanzar).

Mientras esperas AWS OpsWorks para crear tu Puppet Master, descarga el kit de inicio Configurar el nodo maestro de Puppet con el kit de inicio y las credenciales de la consola de Puppet Enterprise. No espere hasta que el servidor esté online para descargarlos.

Cuando finalice la creación del servidor, tu Puppet Master estará disponible en la página principal OpsWorks de Puppet Enterprise, con el estado en línea. Una vez que el servidor esté online, la consola de Puppet Enterprise estará disponible en el dominio del servidor, en una URL en el siguiente formato: https://your_server_name-randomID.region.opsworks-cm.io.

Asegúrese de completar los Requisitos previos. Para crear el nodo maestro de Puppet, necesita un ID de subred, por lo que debe disponer de una VPC.

Cree un rol de servicio y un perfil de instancia. AWS OpsWorks proporciona una AWS CloudFormation plantilla que puede utilizar para crear ambos. Ejecuta el siguiente AWS CLI comando para crear una AWS CloudFormation pila que cree automáticamente el rol de servicio y el perfil de instancia.

aws cloudformation create-stack --stack-name OpsWorksCMRoles --template-url https://s3.amazonaws.com/opsworks-cm-us-east-1-prod-default-assets/misc/opsworks-cm-roles.yaml --capabilities CAPABILITY_NAMED_IAM

Cuando AWS CloudFormation termines de crear la pila, busca y copia los ARN de las funciones de servicio de tu cuenta.

aws iam list-roles --path-prefix "/service-role/" --no-paginate

En los resultados del comando list-roles, busque entradas de ARN del rol de servicio que tengan el siguiente aspecto. Anote los ARN de rol de servicio. Necesitará estos valores cuando cree el maestro de Puppet Enterprise.

{
    "AssumeRolePolicyDocument": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "ec2.amazonaws.com"
                }
            }
        ]
    },
    "RoleId": "AROZZZZZZZZZZQG6R22HC",
    "CreateDate": "2018-01-05T20:42:20Z",
    "RoleName": "aws-opsworks-cm-ec2-role",
    "Path": "/service-role/",
    "Arn": "arn:aws:iam::000000000000:role/service-role/aws-opsworks-cm-ec2-role"
},
{
    "AssumeRolePolicyDocument": {
        "Version": "2012-10-17",
        "Statement": [
            {
                "Action": "sts:AssumeRole",
                "Effect": "Allow",
                "Principal": {
                    "Service": "opsworks-cm.amazonaws.com"
                }
            }
        ]
    },
    "RoleId": "AROZZZZZZZZZZZZZZZ6QE",
    "CreateDate": "2018-01-05T20:42:20Z",
    "RoleName": "aws-opsworks-cm-service-role",
    "Path": "/service-role/",
    "Arn": "arn:aws:iam::000000000000:role/service-role/aws-opsworks-cm-service-role"
}

Busque y copie los ARN de perfiles de instancia de su cuenta.

aws iam list-instance-profiles --no-paginate

En los resultados del comando list-instance-profiles, busque entradas de ARN del perfil de instancia que tengan el siguiente aspecto. Anote los ARN de perfil de instancia. Necesitará estos valores cuando cree el maestro de Puppet Enterprise.

{
    "Path": "/",
    "InstanceProfileName": "aws-opsworks-cm-ec2-role",
    "InstanceProfileId": "EXAMPLEDC6UR3LTUW7VHK",
    "Arn": "arn:aws:iam::123456789012:instance-profile/aws-opsworks-cm-ec2-role",
    "CreateDate": "2017-01-05T20:42:20Z",
    "Roles": [
        {
            "Path": "/service-role/",
            "RoleName": "aws-opsworks-cm-ec2-role",
            "RoleId": "EXAMPLEE4STNUQG6R22HC",
            "Arn": "arn:aws:iam::123456789012:role/service-role/aws-opsworks-cm-ec2-role",
            "CreateDate": "2017-01-05T20:42:20Z",
            "AssumeRolePolicyDocument": {
                "Version": "2012-10-17",
                "Statement": [
                    {
                        "Effect": "Allow",
                        "Principal": {
                            "Service": "ec2.amazonaws.com"
                        },
                        "Action": "sts:AssumeRole"
                    }
                ]
            }
        }
    ]
},

Cree el servidor principal OpsWorks de Puppet Enterprise ejecutando el create-server comando.

aws opsworks-cm create-server --engine "Puppet" --engine-model "Monolithic" --engine-version "2019" --server-name "server_name" --instance-profile-arn "instance_profile_ARN" --instance-type "instance_type" --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"ASCII_password"}' --key-pair "key_pair_name" --preferred-maintenance-window "ddd:hh:mm" --preferred-backup-window "ddd:hh:mm" --security-group-ids security_group_id1 security_group_id2 --service-role-arn "service_role_ARN" --subnet-ids subnet_ID

A continuación, se muestra un ejemplo.

aws opsworks-cm create-server --engine "Puppet" --engine-model "Monolithic" --engine-version "2019" --server-name "puppet-02" --instance-profile-arn "arn:aws:iam::111122223333:instance-profile/aws-opsworks-cm-ec2-role" --instance-type "m5.xlarge" --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"zZZzDj2DLYXSZFRv1d"}' --key-pair "amazon-test" --preferred-maintenance-window "Mon:08:00" --preferred-backup-window "Sun:02:00" --security-group-ids sg-b00000001 sg-b0000008 --service-role-arn "arn:aws:iam::111122223333:role/service-role/aws-opsworks-cm-service-role" --subnet-ids subnet-383daa71

En el ejemplo siguiente se crea un servidor maestro de Puppet que utiliza un dominio personalizado.

aws opsworks-cm create-server \
    --engine "Puppet" \
    --engine-model "Monolithic" \
    --engine-version "2019" \
    --server-name "puppet-02" \
    --instance-profile-arn "arn:aws:iam::111122223333:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "m5.xlarge" \
    --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"zZZzDj2DLYXSZFRv1d"}' \
    --custom-domain "my-puppet-master.my-corp.com" \
    --custom-certificate "-----BEGIN CERTIFICATE----- EXAMPLEqEXAMPLE== -----END CERTIFICATE-----" \
    --custom-private-key "-----BEGIN RSA PRIVATE KEY----- EXAMPLEqEXAMPLE= -----END RSA PRIVATE KEY-----" \
    --key-pair "amazon-test" 
    --preferred-maintenance-window "Mon:08:00" \
    --preferred-backup-window "Sun:02:00" \
    --security-group-ids sg-b00000001 sg-b0000008 \
    --service-role-arn "arn:aws:iam::111122223333:role/service-role/aws-opsworks-cm-service-role" \
    --subnet-ids subnet-383daa71

En el ejemplo siguiente, se crea un nodo maestro de Puppet que agrega dos etiquetas: Stage: Production y Department: Marketing. Para obtener más información sobre cómo añadir y administrar etiquetas en OpsWorks los servidores de Puppet Enterprise, consulte Trabajar con etiquetas en AWS OpsWorks for Puppet Enterprise los recursos esta guía.

aws opsworks-cm create-server \
    --engine "Puppet" \
    --engine-model "Monolithic" \
    --engine-version "2019" \
    --server-name "puppet-02" \
    --instance-profile-arn "arn:aws:iam::111122223333:instance-profile/aws-opsworks-cm-ec2-role" \
    --instance-type "m5.xlarge" \
    --engine-attributes '{"PUPPET_ADMIN_PASSWORD":"zZZzDj2DLYXSZFRv1d"}' \
    --key-pair "amazon-test" 
    --preferred-maintenance-window "Mon:08:00" \
    --preferred-backup-window "Sun:02:00" \
    --security-group-ids sg-b00000001 sg-b0000008 \
    --service-role-arn "arn:aws:iam::111122223333:role/service-role/aws-opsworks-cm-service-role" \
    --subnet-ids subnet-383daa71 \
    --tags [{\"Key\":\"Stage\",\"Value\":\"Production\"},{\"Key\":\"Department\",\"Value\":\"Marketing\"}]

OpsWorks en el caso de Puppet Enterprise, se tarda unos 15 minutos en crear un servidor nuevo. No descarte la salida del comando create-server ni cierre la sesión del shell, ya que la salida puede contener información importante que no se volverá a mostrar. Para obtener las contraseñas y el kit de inicio de los resultados de create-server, continúe en el siguiente paso.

Si está utilizando un dominio personalizado con el servidor, en la salida del comando create-server, copie el valor del atributo Endpoint. A continuación, se muestra un ejemplo.

"Endpoint": "puppet-07-exampleexample.opsworks-cm.us-east-1.amazonaws.com"

Si ha optado OpsWorks por que Puppet Enterprise genere una contraseña para usted, puede extraerla en un formato utilizable a partir de los create-server resultados utilizando un procesador JSON como jq. Después de instalar jq, puede ejecutar los siguientes comandos para extraer la contraseña de administrador y el kit de inicio de Puppet. Si no ha proporcionado su propia contraseña en el paso 3, asegúrese de guardar la contraseña de administrador extraída en un lugar cómodo y seguro.

#Get the Puppet password:
cat resp.json | jq -r '.Server.EngineAttributes[] | select(.Name == "PUPPET_ADMIN_PASSWORD") | .Value'

#Get the Puppet Starter Kit:
cat resp.json | jq -r '.Server.EngineAttributes[] | select(.Name == "PUPPET_STARTER_KIT") | .Value' | base64 -D > starterkit.zip

Si no está utilizando un dominio personalizado, vaya al paso siguiente. Si utiliza un dominio personalizado con el servidor, cree una entrada CNAME en la herramienta de administración de DNS de su empresa para dirigir su dominio personalizado al punto final de Puppet Enterprise que OpsWorks copió en el paso 6. No puede acceder a un servidor con un dominio personalizado ni iniciar sesión en él hasta que complete este paso.

Continúe en la sección siguiente, Configurar el nodo maestro de Puppet con el kit de inicio.