Implementa una aplicación de ASP.NET en Compute Engine

En este instructivo, se describe cómo implementar una aplicación web .NET en Compute Engine.

Este instructivo está dirigido a desarrolladores y a ingenieros DevOps que tengan conocimientos básicos de Microsoft .NET y Compute Engine.

Objetivos

Implementa una aplicación web de ASP.NET Core que use .NET 6 y se ejecute en Linux en una sola instancia de Compute Engine.

Nota: Para obtener información sobre cómo implementar una aplicación web de ASP.NET Model-View-Controller (MVC) que use .NET Framework 4 y se ejecute en Windows, consulta Implementa una aplicación ASP.NET MVC en Compute Engine.

En este instructivo, se muestra cómo completar las siguientes tareas para alcanzar tu objetivo:

• Implementa una VM de Compute Engine
• Configura el balanceo de cargas
• Implementa la aplicación ASP.NET

Costos

En este documento, usarás los siguientes componentes facturables de Google Cloud:

• Compute Engine virtual machine (VM) instances
• Compute Engine persistent disks

Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios.

Es posible que los usuarios de Google Cloud nuevos cumplan con los requisitos para acceder a una prueba gratuita.

Cuando completes las tareas que se describen en este documento, podrás borrar los recursos que creaste para evitar que se te siga facturando. Para obtener más información, consulta Realiza una limpieza.

Antes de comenzar

Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Compute Engine API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

Implementa una VM de Compute Engine

En esta sección, se muestra cómo crear una VM de Linux o una VM de Windows Server que ejecute servidores web de Microsoft Internet Information Services (IIS) en Compute Engine.

1. Establece los valores predeterminados de tu ID del proyecto y tu zona de Compute Engine. Esto te ayuda a ahorrar tiempo.

   gcloud config set project PROJECT_ID
   gcloud config set compute/zone ZONE
   

   Reemplaza lo siguiente:

   • PROJECT_ID por el ID de tu Google Cloud proyecto.
   • ZONE por el nombre de la zona que usarás para crear recursos. Si no estás seguro de qué zona elegir, usa la zona ubicada geográficamente más cerca de ti.

   Por ejemplo:

   gcloud config set project test-project-12345
   gcloud config set compute/zone us-central1-a
   

2. Cree una instancia de VM:

   Para crear una VM de Linux, haz lo siguiente:

   1. Crea una secuencia de comandos de inicio para la instancia de VM. La secuencia de comandos se ejecuta durante la inicialización de la VM y se instala el entorno de ejecución de .NET:

      "if ! dpkg-query -W aspnetcore-runtime-6.0
      then
          curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb  -O
          sudo dpkg -i packages-microsoft-prod.deb
          rm packages-microsoft-prod.deb
          sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-6.0
      fi
      " | Out-File -Encoding ASCII startup.sh
      

   2. Crea la instancia de VM y usa startup.sh como secuencia de comandos de inicio:

      gcloud compute instances create clouddemo-1 `
          --image-family debian-11 `
          --image-project debian-cloud `
          --machine-type n1-standard-2 `
          --boot-disk-type pd-ssd `
          --tags loadbalancer-backend `
          --metadata-from-file startup-script=startup.sh
      

3. Supervisa el proceso de inicialización de la VM cuando ves su salida de puerto en serie:

   gcloud compute instances tail-serial-port-output clouddemo-1
   

   Espera unos 5 minutos hasta que veas el resultado Instance setup finished o Startup finished y, luego, presiona Ctrl + C. En este punto, ya se completó la instalación de los requisitos, y la instancia de VM está lista para usarse.

Configura el balanceo de cargas

Para que tu app de ASP.NET esté disponible en Internet, debes usar un balanceador de cargas HTTPS. Para asociar tu instancia de VM con el balanceador de cargas, crea un grupo de instancias y asigna este grupo al balanceador de cargas:

1. Crea un grupo de instancias no administrado y agrega la instancia de VM:

   gcloud compute instance-groups unmanaged create clouddemo-1
   gcloud compute instance-groups unmanaged add-instances clouddemo-1 --instances clouddemo-1
   

2. Crea una verificación de estado que compruebe si el servidor web se está ejecutando:

   gcloud compute http-health-checks create clouddemo-health `
       --check-interval 5s `
       --unhealthy-threshold 2 `
       --request-path / `
       --port 5000
   gcloud compute instance-groups set-named-ports clouddemo-1 --named-ports=http:5000
   

3. Crea un servicio de backend para el balanceador de cargas que use la verificación de estado HTTP y el grupo de instancias que creaste antes:

   gcloud compute backend-services create clouddemo-backend `
     --http-health-checks clouddemo-health `
     --port-name http `
     --protocol HTTP `
     --global
   gcloud compute backend-services add-backend clouddemo-backend `
     --instance-group clouddemo-1 `
     --global `
     --instance-group-zone $(gcloud config get-value compute/zone)
   

4. Crea un frontend para el balanceador de cargas:

   gcloud compute url-maps create clouddemo-map --default-service clouddemo-backend
   gcloud compute target-http-proxies create clouddemo-proxy --url-map clouddemo-map
   gcloud compute forwarding-rules create clouddemo-frontend --global --target-http-proxy clouddemo-proxy --ports 80
   

5. Crea una regla de firewall que permita que el balanceador de cargas envíe solicitudes HTTP a las instancias que tengan la etiqueta loadbalancer-backend.

   gcloud compute firewall-rules create loadbalancer-backend `
     --source-ranges "130.211.0.0/22,35.191.0.0/16" `
     --target-tags loadbalancer-backend `
     --allow tcp:80,tcp:5000
   

6. Busca la dirección IP del balanceador de cargas:

   gcloud compute forwarding-rules describe clouddemo-frontend --global --format "value(IPAddress)"
   

   Anota la dirección IP. Lo necesitarás más tarde.

Implementa la aplicación ASP.NET

1. Abre una consola de PowerShell.

2. Descarga y descomprime o clona el repositorio de muestra desde github:

   git clone https://github.com/GoogleCloudPlatform/dotnet-docs-samples.git
   

3. Compila el paquete de implementación:

   1. Cambia al directorio que contiene la aplicación de ejemplo:

      cd dotnet-docs-samples\applications\clouddemo\netcore
      

   2. Compila la solución:

      dotnet publish -c Release
      

4. Copia el paquete de implementación en la VM:

   1. Copia el contenido de la carpeta publish en tu directorio principal de la VM:

      gcloud compute scp --recurse CloudDemo.MvcCore\bin\Release\net6.0\publish clouddemo-1:
      

   2. Conéctate a la VM con SSH.

   3. En la VM, crea una carpeta /var/www/clouddemo y copia los archivos de la aplicación en esta carpeta:

      sudo mkdir -p /var/www/clouddemo
      sudo chown -R www-data:www-data /var/www/clouddemo
      sudo cp -r publish/* /var/www/clouddemo
      

   4. Registra la aplicación como una unidad de systemd:

      cat <<EOF > kestrel-clouddemo.service
      [Unit]
      Description=Cloud Demo ASP.NET app
      
      [Service]
      WorkingDirectory=/var/www/clouddemo
      ExecStart=/usr/bin/dotnet /var/www/clouddemo/CloudDemo.MvcCore.dll
      Restart=always
      Environment=ASPNETCORE_ENVIRONMENT=Production
      Environment=ASPNETCORE_URLS=http://0.0.0.0:5000
      
      [Install]
      WantedBy=multi-user.target
      EOF
      
      sudo mv kestrel-clouddemo.service /etc/systemd/system/
      sudo systemctl daemon-reload
      sudo systemctl start kestrel-clouddemo
      

5. En tu computadora local, abre un navegador web y ve a la siguiente dirección:

   http://LOADBALANCER_IP/
   

   Reemplaza LOADBALANCER_IP por la dirección IP que obtuviste después de implementar el balanceador de cargas.

   Ahora verás la aplicación de demostración y el título Esta app se ejecuta en Compute Engine.

Limpia

Una vez que completes el instructivo, puedes limpiar los recursos que creaste para que dejen de usar la cuota y generar cargos. En las siguientes secciones, se describe cómo borrar o desactivar estos recursos.

Borra el proyecto

La manera más fácil de eliminar la facturación es borrar el proyecto que creaste para el instructivo.

Precaución: Borrar un proyecto tiene estas consecuencias:

• Se borra todo su contenido. Si usaste un proyecto existente para las tareas de este documento, cuando lo borres, también se borrará cualquier otro trabajo que hayas realizado en el proyecto.
• Se pierden los IDs personalizados de los proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID personalizado del proyecto que desees utilizar en el futuro. Para conservar las URLs que usan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto, en lugar de todo el proyecto.

Si planeas explorar varios instructivos, arquitecturas o guías de inicio rápido, reutilizar proyectos puede ser útil para no exceder los límites de cuota de los proyectos.

Borra un Google Cloud proyecto:

gcloud projects delete PROJECT_ID

Borra los recursos individuales

Deberás borrar individualmente todos los recursos creados para el proyecto (por ejemplo: grupos de instancias, verificaciones de estado, servicios de backend, proxy HTTP y reglas de reenvío). No puedes borrar las instancias de VM hasta que borres todos estos recursos.

¿Qué sigue?

• Obtén más información para crear y ejecutar máquinas virtuales en la infraestructura de Google.
• Revisa las prácticas recomendadas en el Google Cloud Framework de Well-Architected.
• Explora arquitecturas de referencia, diagramas y prácticas recomendadas sobre Google Cloud. Consulta nuestro Cloud Architecture Center.