QuickStart: Despliegue un. NETAplicación Core on Windows a Elastic Beanstalk

Este QuickStart tutorial lo guía a través del proceso de creación de un. NETCentrarse en la aplicación Windows e implementarla en un AWS Elastic Beanstalk entorno.

nota

Este QuickStart tutorial está destinado a fines de demostración. No utilice la aplicación creada en este tutorial para el tráfico de producción.

Tu AWS cuenta

Si aún no eres AWS cliente, debes crear una AWS cuenta. El registro le permite acceder a Elastic Beanstalk AWS y a otros servicios que necesite.

Si ya tiene una AWS cuenta, puede pasar a. Requisitos previos

Crea una AWS cuenta

Inscríbase en una Cuenta de AWS

Si no tiene uno Cuenta de AWS, complete los siguientes pasos para crearlo.

Para suscribirte a una Cuenta de AWS

1. Abrir https://portal.aws.amazon.com/billing/registro.

2. Siga las instrucciones que se le indiquen.

   Parte del procedimiento de registro consiste en recibir una llamada telefónica e indicar un código de verificación en el teclado del teléfono.

   Cuando te registras en un Cuenta de AWS, Usuario raíz de la cuenta de AWSse crea un. El usuario raíz tendrá acceso a todos los Servicios de AWS y recursos de esa cuenta. Como práctica recomendada de seguridad, asigne acceso administrativo a un usuario y utilice únicamente el usuario raíz para realizar tareas que requieren acceso de usuario raíz.

AWS te envía un correo electrónico de confirmación una vez finalizado el proceso de registro. Puede ver la actividad de la cuenta y administrar la cuenta en cualquier momento entrando en https://aws.amazon.com/ y seleccionando Mi cuenta.

Creación de un usuario con acceso administrativo

Después de crear un usuario administrativo Cuenta de AWS, asegúrelo Usuario raíz de la cuenta de AWS AWS IAM Identity Center, habilite y cree un usuario administrativo para no usar el usuario root en las tareas diarias.

Proteja su Usuario raíz de la cuenta de AWS

1. Inicie sesión AWS Management Consolecomo propietario de la cuenta seleccionando el usuario root e introduciendo su dirección de Cuenta de AWS correo electrónico. En la siguiente página, escriba su contraseña.

   Para obtener ayuda para iniciar sesión con el usuario raíz, consulte Iniciar sesión como usuario raíz en la Guía del usuario de AWS Sign-In .

2. Activa la autenticación multifactorial (MFA) para tu usuario root.

   Para obtener instrucciones, consulte Habilitar un MFA dispositivo virtual para el usuario Cuenta de AWS root (consola) en la Guía del IAM usuario.

Creación de un usuario con acceso administrativo

1. Habilite IAM Identity Center.

   Consulte las instrucciones en Activar AWS IAM Identity Center en la Guía del usuario de AWS IAM Identity Center .

2. En IAM Identity Center, conceda acceso administrativo a un usuario.

   Para ver un tutorial sobre cómo usar el Directorio de IAM Identity Center como fuente de identidad, consulte Configurar el acceso de los usuarios con la configuración predeterminada Directorio de IAM Identity Center en la Guía del AWS IAM Identity Center usuario.

Iniciar sesión como usuario con acceso de administrador

• Para iniciar sesión con su usuario de IAM Identity Center, utilice el inicio de sesión URL que se envió a su dirección de correo electrónico cuando creó el usuario de IAM Identity Center.

  Para obtener ayuda para iniciar sesión con un usuario de IAM Identity Center, consulte Iniciar sesión en el portal de AWS acceso en la Guía del AWS Sign-In usuario.

Concesión de acceso a usuarios adicionales

1. En IAM Identity Center, cree un conjunto de permisos que siga la práctica recomendada de aplicar permisos con privilegios mínimos.

   Para conocer las instrucciones, consulte Create a permission set en la Guía del usuario de AWS IAM Identity Center .

2. Asigne usuarios a un grupo y, a continuación, asigne el acceso de inicio de sesión único al grupo.

   Para conocer las instrucciones, consulte Add groups en la Guía del usuario de AWS IAM Identity Center .

Requisitos previos

Para seguir los procedimientos de esta guía, necesitará un shell o un terminal de línea de comando donde pueda ejecutar los comandos. Los comandos se muestran en los listados precedidos de un símbolo de aviso (>) y del nombre del directorio actual, si procede.

C:\eb-project> this is a command
this is output

EB CLI

En este tutorial se utiliza la interfaz de línea de comandos (EB) de Elastic Beanstalk. CLI Para obtener información detallada sobre la instalación y configuración del EBCLI, consulte y. Instalación de la CLI de EB Configuración de la CLI de EB

. NETCore en Windows

Si no tienes el. NETSDKinstalado en su máquina local, puede instalarlo siguiendo la descarga. NETenlace en. NETsitio web de documentación.

Verifica tu. NETSDKinstalación ejecutando el siguiente comando.

C:\> dotnet --info

Paso 1: Crea un. NETCore en la aplicación Windows

Cree el directorio del proyecto.

C:\> mkdir eb-dotnetcore
C:\> cd eb-dotnetcore

A continuación, cree un ejemplo de aplicación de servicio RESTful web Hello World ejecutando los siguientes comandos.

C:\eb-dotnetcore> dotnet new web --name HelloElasticBeanstalk
C:\eb-dotnetcore> cd HelloElasticBeanstalk

Paso 2: Ejecute la aplicación localmente

Ejecute el siguiente comando para ejecutar la aplicación localmente.

C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet run

El resultado debería tener un aspecto similar al siguiente texto.

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: https://localhost:7222
info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5228
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
      Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
      Content root path: C:\Users\Administrator\eb-dotnetcore\HelloElasticBeanstalk

nota

El dotnet comando selecciona un puerto al azar al ejecutar la aplicación localmente. En este ejemplo, el puerto es 5228. Al implementar la aplicación en el entorno de Elastic Beanstalk, la aplicación se ejecutará en el puerto 5000.

Introduzca la URL dirección http://localhost:port en su navegador web. Para este ejemplo específico, el comando eshttp://localhost:5228. El navegador web debería mostrar «¡Hola mundo!».

Paso 3: Implemente su. NETCore en la aplicación Windows con el EB CLI

Ejecute los siguientes comandos para crear un entorno de Elastic Beanstalk para esta aplicación.

Para crear un entorno e implementar su. NETCore en la aplicación Windows

1. Ejecute los siguientes comandos en el HelloElasticBeanstalk directorio para publicar y comprimir la aplicación.

   C:\eb-dotnetcore\HelloElasticBeasntalk> dotnet publish -o site
   C:\eb-dotnetcore\HelloElasticBeasntalk> cd site
   C:\eb-dotnetcore\HelloElasticBeasntalk\site> Compress-Archive -Path * -DestinationPath ../site.zip
   C:\eb-dotnetcore\HelloElasticBeasntalk\site> cd ..

2. Cree un nuevo archivo en la HelloElasticBeanstalk llamada aws-windows-deployment-manifest.json con el siguiente contenido:

   {
       "manifestVersion": 1,
       "deployments": {
           "aspNetCoreWeb": [
           {
               "name": "test-dotnet-core",
               "parameters": {
                   "appBundle": "site.zip",
                   "iisPath": "/",
                   "iisWebSite": "Default Web Site"
               }
           }
           ]
       }
   }

3. Inicialice su CLI repositorio EB con el eb init comando.

   C:\eb-dotnetcore\HelloElasticBeasntalk> eb init -p iis dotnet-windows-server-tutorial --region us-east-2

   Este comando crea una aplicación denominada dotnet-windows-server-tutorial y configura el repositorio local para crear entornos con la versión más reciente de la plataforma de servidor Windows.

4. Cree un entorno e implemente la aplicación en él con eb create. Elastic Beanstalk crea automáticamente un archivo zip para la aplicación y lo inicia en el puerto 5000.

   C:\eb-dotnetcore\HelloElasticBeasntalk> eb create dotnet-windows-server-env

   Elastic Beanstalk tarda unos cinco minutos en crear el entorno.

Paso 4: Ejecute la aplicación en Elastic Beanstalk

Cuando finalice el proceso de creación del entorno, abra su sitio web con. eb open

C:\eb-dotnetcore\HelloElasticBeasntalk> eb open

¡Enhorabuena! Ha implementado un. NET¡Núcleo en la aplicación Windows con Elastic Beanstalk! Se abre una ventana del navegador con el nombre de dominio creado para su aplicación.

Paso 5: Eliminar

Puede cerrar su entorno cuando termine de trabajar con la aplicación. Elastic Beanstalk AWS cancela todos los recursos asociados a su entorno.

Para finalizar el entorno de Elastic Beanstalk con el EB, ejecute CLI el siguiente comando.

C:\eb-dotnetcore\HelloElasticBeasntalk> eb terminate

AWS recursos para su aplicación

Acabas de crear una aplicación de instancia única. Sirve como una aplicación de muestra sencilla con una sola EC2 instancia, por lo que no requiere balanceo de carga ni escalado automático. Para las aplicaciones de instancia única, Elastic Beanstalk crea los siguientes recursos: AWS

• EC2instancia: una máquina EC2 virtual de Amazon configurada para ejecutar aplicaciones web en la plataforma que elija.

  Cada plataforma ejecuta un conjunto distinto de software, archivos de configuración y scripts compatibles con una determinada versión de lenguaje, marco y contenedor web (o una combinación de ellos). La mayoría de las plataformas utilizan Apache o nginx como un proxy inverso que procesa el tráfico web delante de la aplicación web, reenvía las solicitudes a esta, administra los recursos estáticos y genera registros de acceso y errores.

• Grupo de seguridad de instancias: un grupo EC2 de seguridad de Amazon configurado para permitir el tráfico entrante en el puerto 80. Este recurso permite que el HTTP tráfico del balanceador de cargas llegue a la EC2 instancia que ejecuta tu aplicación web. De forma predeterminada, el tráfico no está permitido en otros puertos.

• Bucket de Amazon S3: ubicación de almacenamiento para el código fuente, los registros y otros artefactos que se crean al utilizar Elastic Beanstalk.

• CloudWatch Alarmas de Amazon: dos CloudWatch alarmas que monitorean la carga de las instancias de su entorno y se activan si la carga es demasiado alta o demasiado baja. Cuando se activa una alarma, en respuesta, el grupo de Auto Scaling aumenta o reduce los recursos.

• AWS CloudFormation pila: Elastic AWS CloudFormation Beanstalk se utiliza para lanzar los recursos de su entorno y propagar los cambios de configuración. Los recursos se definen en una plantilla que puede verse en la consola de AWS CloudFormation.

• Nombre de dominio: un nombre de dominio que se dirige a su aplicación web en el formulario subdomain.region.elasticbeanstalk.com.

Elastic Beanstalk administra todos estos recursos. Cuando termina su entorno, Elastic Beanstalk termina todos los recursos que este contiene.

Siguientes pasos

Una vez que disponga de un entorno que ejecute una aplicación, podrá implementar una nueva versión de la aplicación o una aplicación distinta en cualquier momento. La implementación de una nueva versión de la aplicación es muy rápida porque no requiere aprovisionar ni reiniciar las instancias. EC2 También puede explorar su nuevo entorno con la consola de Elastic Beanstalk. Para ver los pasos detallados, consulte Explore su entorno en el capítulo Introducción de esta guía.

Pruebe más tutoriales

Si desea probar otros tutoriales con diferentes aplicaciones de ejemplo, consulteQuickStart ASPpara. NET.

Después de implementar una o dos aplicaciones de muestra y estar listo para empezar a desarrollarlas y ejecutarlas. NETHaga hincapié en las aplicaciones de Windows de forma local, consulte Configuración del entorno de desarrollo de .NET

Implemente con la consola de Elastic Beanstalk

También puede usar la consola de Elastic Beanstalk para iniciar la aplicación de muestra. Para ver los pasos detallados, consulte Crear una aplicación de ejemplo en el capítulo Introducción de esta guía.