Comienza a usar .NET

Este instructivo está destinado a aquellos que estén comenzando a compilar aplicaciones en la nube, como ingenieros y desarrolladores web, que quieran aprender conceptos clave del desarrollo de aplicaciones y aplicarlos a Google Cloud.

Objetivos

• Aprender sobre las herramientas básicas de Google Cloud, como Google Cloud Console y gcloud
• Implementar tu app en Cloud Run
• Almacenar tus datos con Firestore
• Almacenar archivos subidos en Cloud Storage
• Supervisar la app mediante Google Cloud's operations suite

Costos

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

• Cloud Run
• Cloud Storage
• Firestore
• Google Cloud's operations suite

Las instrucciones de este documento están diseñadas para que el uso de los recursos se mantenga dentro de los límites del nivel Siempre gratuito de Google Cloud. Para generar una estimación de costos en función del uso previsto, usa la calculadora de precios. Es posible que los usuarios nuevos de Google Cloud califiquen para obtener una prueba gratuita.

Cuando finalices las tareas que se describen en este documento, puedes borrar los recursos que creaste para evitar que continúe la facturación. Para obtener más información, consulta Cómo realizar una limpieza.

Antes de comenzar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

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

   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

5. Make sure that billing is enabled for your Google Cloud project.

6. Para crear una base de datos de Firestore en modo nativo, sigue los pasos a continuación:
   1. En Cloud Console, dirígete a la página del visualizador de Firestore.
      Ir al visualizador de Firestore
   2. En la pantalla Selecciona un modo de Cloud Firestore, haz clic en Seleccionar modo nativo.
   3. Selecciona una ubicación para tu base de datos de Firestore. Esta configuración corresponde a la ubicación predeterminada de los recursos de Google Cloud que definiste en el proyecto de Cloud. La configuración de la ubicación se usa en los servicios de Google Cloud del proyecto que la requieren; en particular, el bucket predeterminado de Cloud Storage y la aplicación de Cloud Run.
      Advertencia: Una vez que configures la ubicación predeterminada de los recursos del proyecto de Cloud, no podrás cambiarla.
   4. Haga clic en Crear base de datos.

7. Enable the Cloud Run, Cloud Storage JSON, Cloud Logging, and Error Reporting APIs.

   Enable the APIs

8. Clona el repositorio de muestra y abre la aplicación de muestra en Cloud Shell:
   Ir a Cloud Shell

   Cloud Shell brinda acceso de línea de comandos a tus recursos de Google Cloud de forma directa desde el navegador.

9. Para descargar el código de muestra y cambiar al directorio de la app, haz clic en Continuar.

10. En Cloud Shell, configura la herramienta de gcloud para que use tu proyecto de Google Cloud nuevo de la manera siguiente:

    # Configure gcloud for your project
    gcloud config set project PROJECT_ID
    

    Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud que creaste mediante Cloud Console.

    La CLI de Google Cloud es la forma principal en la que interactúas con tus recursos de Google Cloud desde la línea de comandos. En este instructivo, usarás la herramienta gcloud para implementar y supervisar tu aplicación.

Ejecuta la aplicación

1. Ejecute la aplicación:

   GOOGLE_CLOUD_PROJECT=PROJECT_ID dotnet run
   

   Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud que creaste.
2. En Cloud Shell, haz clic en Vista previa en la Web y selecciona Vista previa en el puerto 8080. Se abrirá una ventana nueva con tu app en ejecución.

Implementa tu app en Cloud Run

Google Cloud ofrece varias opciones para ejecutar tu código. Para este ejemplo, usa Cloud Run a fin de implementar una app escalable en Google Cloud. Gracias a que no necesitas que se administren servidores, Cloud Run te permite enfocarte en escribir código. Además, Cloud Run escala automáticamente para admitir los aumentos de tráfico repentinos.

El Dockerfile le indica a Cloud Run cómo ejecutar la app:

Biblioteca/Dockerfile

Ver en GitHub

FROM mcr.microsoft.com/dotnet/core/aspnet:2.1
COPY . /app
WORKDIR /app
ENTRYPOINT ["dotnet", "Bookshelf.dll"]

Los Dockerfiles pueden ser más completos, pero esta configuración funciona para muchas aplicaciones.

Cloud Run le indica a tu app qué puerto debe escuchar mediante la configuración de la variable de entorno PORT. Program.cs de la estantería contiene código para observar la variable PORT y escuchar en ese puerto:

Book/Program.cs

Ver en GitHub

using Google.Cloud.Diagnostics.AspNetCore;
using Microsoft.AspNetCore;
using Microsoft.AspNetCore.Hosting;
using System;

namespace Bookshelf
{
    public class Program
    {
        public static void Main(string[] args)
        {
            CreateWebHostBuilder(args).Build().Run();
        }

        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
            WebHost.CreateDefaultBuilder(args)
                .UseGoogleDiagnostics(Startup.GetProjectId(), "Bookshelf", "0.01")
                .UseStartup<Startup>().UsePortEnvironmentVariable();
    }

    static class ProgramExtensions
    {
        // Google Cloud Run sets the PORT environment variable to tell this
        // process which port to listen to.
        public static IWebHostBuilder UsePortEnvironmentVariable(
            this IWebHostBuilder builder)
        {
            string port = Environment.GetEnvironmentVariable("PORT");
            if (!string.IsNullOrEmpty(port))
            {
                builder.UseUrls($"http://0.0.0.0:{port}");
            }
            return builder;
        }
    }
}

En la ventana de la terminal, implementa la app en Cloud Run mediante la CLI de gcloud:

1. Compila la app de forma local.

   dotnet publish -c Release
   

2. Usar Cloud Build para compilar un contenedor de Docker y publicar en Container Registry

   gcloud builds submit --tag gcr.io/PROJECT_ID/bookshelf \
       bin/Release/netcoreapp2.1/publish
   

3. Ejecuta el contenedor con Cloud Run.

   gcloud run deploy bookshelf --region us-central1 --platform managed \
       --image gcr.io/PROJECT_ID/bookshelf --allow-unauthenticated
   

   Ahora se puede ver tu app en la URL que se muestra en el resultado de gcloud run:

   Service [bookshelf] revision [bookshelf-00001] has been deployed and is serving traffic at
   https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app
   

4. Copia la URL a tu navegador web para ver la app.
   Nota: Este dominio protegido por SSL se crea automáticamente y es útil para el desarrollo. Además, con Cloud Run, puedes configurar un dominio personalizado.

Para obtener más información sobre la implementación en Cloud Run, consulta la documentación de Cloud Run.

Almacena tus datos con Firestore

No se puede almacenar información en tus instancias de Cloud Run porque se perderá si se reinicia la instancia, además de que no existirá cuando se creen instancias nuevas. En su lugar, usarás una base de datos en la que todas tus instancias puedan leer y escribir.

Google Cloud ofrece varias opciones para almacenar tus datos. En este ejemplo, usarás Firestore para almacenar los datos de cada libro. Firestore es una base de datos de documentos NoSQL, completamente administrada y sin servidores que te permite almacenar y consultar datos. Firestore escala de manera automática para cumplir las necesidades de tu aplicación y escala a cero cuando no la estás usando. Agrega el primer libro:

1. Para crear un libro en tu aplicación implementada, haz clic en Add book (Agregar libro).

   
2. En el campo Title, ingresa Moby Dick.
3. En el campo Author, ingresa Herman Melville.

4. Haz clic en Guardar. Ya tienes una entrada en la aplicación Bookshelf.

   

5. En Cloud Console, ve a Cloud Firestore. Ir a Cloud Firestore

   Los datos aparecen en Firestore. La aplicación Bookshelf almacena cada libro como un documento de Firestore con un ID único, y todos estos documentos se almacenan en una colección de Firestore. A los fines de este instructivo, la colección se llama libros.

   

Firestore almacena los libros mediante la biblioteca cliente de Firestore. Aquí hay un ejemplo de recuperación de un documento de Firestore:

Books/Models/FirestoreBookStore.cs

Ver en GitHub

using Google.Cloud.Firestore;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace Bookshelf.Models
{
    class FirestoreBookStore : IBookStore
    {
        private FirestoreDb _firestore;
        private CollectionReference _books;

        public FirestoreBookStore(string projectId)
        {
            _firestore = FirestoreDb.Create(projectId);
            _books = _firestore.Collection("Books");
        }

Para obtener más información sobre el uso de Firestore, consulta cómo agregar datos a Firestore.

Almacena archivos subidos en Cloud Storage

Ahora que agregaste un libro, es momento de agregar su imagen de portada. No puedes almacenar archivos en tus instancias. Una base de datos no es la opción correcta para archivos de imagen. En cambio, debes usar Cloud Storage.

Cloud Storage es el almacenamiento de BLOB principal de Google Cloud. Puedes usar Cloud Storage a fin de alojar elementos de aplicaciones que deseas compartir en Google Cloud. Para usar Cloud Storage, debes crear un bucket de Cloud Storage, un contenedor básico en el que se guardan tus datos.

1. En Cloud Console, ve a la página Navegador de Cloud Storage.

   Ir a la página Navegador de Cloud Storage

2. Haga clic en Crear bucket.
3. En el cuadro de diálogo Crear bucket, adjunta el ID del proyecto de Google Cloud a la string _bucket para ingresar un nombre del bucket, de manera que sea similar a YOUR_PROJECT_ID_bucket. Este nombre está sujeto a los requisitos de nombres de los buckets. En el resto de los campos, se pueden conservar los valores predeterminados.
4. Haga clic en Crear.
5. Una vez que se haya creado el bucket, debe permitirse el acceso público a los objetos para que puedan consultarlos los usuarios. Si quieres permitir el acceso público a tus objetos, consulta el artículo Haz públicos los datos.
6. Haz clic en Edit book y selecciona una imagen para subirla como la portada del libro. Por ejemplo, puedes usar esta imagen de dominio público:
   
7. Haz clic en Save. Se te redireccionará a la página principal, en la que encontrarás una entrada a la app de Bookshelf.
   

La aplicación de Bookshelf envía los archivos subidos a Cloud Storage a través de la biblioteca cliente de Cloud Storage.

Book/Services/ImageUploader.cs

Ver en GitHub

using Google.Cloud.Storage.V1;
using Microsoft.AspNetCore.Http;
using System;
using System.Threading.Tasks;
using System.Web;

namespace Bookshelf.Services
{
    public class ImageUploader
    {
        private readonly string _bucketName;
        private readonly StorageClient _storageClient;

        public ImageUploader(string bucketName)
        {
            _bucketName = bucketName;
            _storageClient = StorageClient.Create();
        }

Nota: Para cambiar el nombre del bucket, configura la variable $bucketId del código anterior con un nombre diferente y vuelve a implementar la app ejecutando gcloud app deploy.

Para obtener más información sobre cómo usar Cloud Storage, consulta la lista de guías prácticas.

Supervisa la app con Google Cloud's operations suite

Ya implementaste la app y creaste y modificaste libros. A fin de supervisar estos eventos para los usuarios, usa la administración del rendimiento de las aplicaciones.

Supervisa los registros con Cloud Logging

1. En Google Cloud, ve al Explorador de registros.

   Ir al Explorador de registros

   Puedes supervisar tu app en tiempo real. Si tienes problemas con tu app, este es uno de los primeros lugares que consultar.

   
2. En la lista desplegable Recursos, selecciona Revisión de Cloud Run, bookshelf.

Supervisa los errores con Error Reporting

1. En Cloud Console, ve a la página Error Reporting.
   Ir a la página Error Reporting
   Error Reporting destaca los errores y las excepciones de la app y te permite configurar alertas basadas en ellos.
2. En el navegador, ve a la URL /Home/Throw en la app.
   Por ejemplo, si la app se aloja en https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app, visita https://bookshelf-lwuhslogjlnpofsxugoc.a.run.app/Home/Throw.

   Esto genera una nueva excepción de prueba y la envía al paquete de operaciones de Google Cloud.

3. En Cloud Console, regresa a la página de Error Reporting y podrás ver el error nuevo en unos instantes. Haz clic en Volver a cargar automáticamente para no tener que actualizar la página de forma manual.

   

Nota: La administración del rendimiento de las aplicaciones cuenta con varias herramientas para ayudarte a depurar y supervisar las apps. Para obtener más información, consulta los instructivos.

Limpia

Para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos usados en este instructivo, borra el proyecto que contiene los recursos o conserva el proyecto y borra los recursos individuales.

Borra el proyecto

Precaución: Borrar un proyecto tiene las siguientes consecuencias:

• Se borra todo en el proyecto. 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 ID personalizados de proyectos. Cuando creaste este proyecto, es posible que hayas creado un ID del proyecto personalizado que desees utilizar en el futuro. Para conservar las URL que utilizan el ID del proyecto, como una URL appspot.com, borra los recursos seleccionados dentro del proyecto en lugar de borrar todo el proyecto.

Si planeas explorar varias infraestructuras, instructivos y guías de inicio rápido la reutilización de proyectos puede ayudarte a evitar exceder los límites de las cuotas del proyecto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

¿Qué sigue?

• Implementa una app en Google Kubernetes Engine
• Implementa una aplicación en Compute Engine
• Maneja sesiones con Firestore