Развертывание приложения ASP.NET Core в App Engine

1. Обзор

ASP.NET Core — это новая кроссплатформенная платформа с открытым исходным кодом для создания современных облачных и подключенных к Интернету приложений с использованием языка программирования C#.

В ходе этой лабораторной работы вы развернете простое приложение ASP.NET Core в гибкой среде App Engine. Эта лаборатория кода основана на сборке и запуске приложения ASP.NET Core из лаборатории кода Google Cloud Shell . Возможно, вы захотите сначала выполнить эту лабораторную работу, прежде чем приступать к этой лабораторной работе.

Приложения Google App Engine легко создавать, поддерживать и масштабировать по мере изменения потребностей в трафике и хранилище данных. Благодаря App Engine вам не придется управлять серверами. Вы просто загружаете свое приложение, и оно готово к работе.

Приложения App Engine автоматически масштабируются в зависимости от входящего трафика. App Engine изначально поддерживает балансировку нагрузки, микросервисы, авторизацию, базы данных SQL и NoSQL, Memcache, разделение трафика, ведение журналов, поиск, управление версиями, развертывание и откат, а также сканирование безопасности, причем все эти функции имеют широкие возможности настройки.

Среды App Engine, стандартная среда и гибкая среда , поддерживают множество языков программирования, включая C#, Java, Python, PHP, Node.js, Go и другие. Эти две среды предоставляют пользователям максимальную гибкость в поведении их приложений, поскольку каждая среда имеет определенные сильные стороны. Дополнительную информацию см. в разделе Выбор среды App Engine .

Что вы узнаете

• Как упаковать простое приложение ASP.NET Core в контейнер Docker.
• Как развернуть простое приложение ASP.NET Core в App Engine.

Что вам понадобится

• Проект облачной платформы Google
• Браузер, например Chrome или Firefox.

Как вы будете использовать этот урок?

Прочтите только до конца Прочитайте его и выполните упражнения.

Как бы вы оценили свой опыт работы с Google Cloud Platform?

Новичок Средний Опытный

2. Настройка и требования

Самостоятельная настройка среды

1. Войдите в Google Cloud Console и создайте новый проект или повторно используйте существующий. Если у вас еще нет учетной записи Gmail или Google Workspace, вам необходимо ее создать .

• Имя проекта — это отображаемое имя для участников этого проекта. Это строка символов, не используемая API Google, и вы можете обновить ее в любое время.
• Идентификатор проекта должен быть уникальным для всех проектов Google Cloud и неизменяемым (нельзя изменить после его установки). Cloud Console автоматически генерирует уникальную строку; обычно тебя не волнует, что это такое. В большинстве лабораторий кода вам потребуется указать идентификатор проекта (обычно он обозначается как PROJECT_ID ), поэтому, если он вам не нравится, создайте другой случайный идентификатор или попробуйте свой собственный и посмотрите, доступен ли он. Затем он «замораживается» после создания проекта.
• Существует третье значение — номер проекта , который используют некоторые API. Подробнее обо всех трех этих значениях читайте в документации .

Внимание: Идентификатор проекта должен быть глобально уникальным и не может быть использован кем-либо еще после того, как вы его выбрали. Вы единственный пользователь с этим идентификатором. Если проект будет удален, этот идентификатор больше никогда не будет использоваться.

Примечание. Если вы используете учетную запись Gmail, вы можете оставить для местоположения по умолчанию значение «Нет организации» . Если вы используете учетную запись Google Workspace, выберите местоположение, подходящее для вашей организации.

2. Затем вам необходимо включить выставление счетов в Cloud Console, чтобы использовать облачные ресурсы/API. Прохождение этой лаборатории кода не должно стоить много, если вообще стоит. Чтобы отключить ресурсы и не платить за выставление счетов за пределами этого руководства, следуйте инструкциям по «очистке», которые можно найти в конце лаборатории кода. Новые пользователи Google Cloud имеют право на участие в программе бесплатной пробной версии стоимостью 300 долларов США .

Запустить Cloud Shell

Хотя Google Cloud можно управлять удаленно с вашего ноутбука, в этой лаборатории вы будете использовать Google Cloud Shell , среду командной строки, работающую в облаке.

Активировать Cloud Shell

1. В Cloud Console нажмите «Активировать Cloud Shell». .

Если вы никогда раньше не запускали Cloud Shell, вам будет представлен промежуточный экран (ниже сгиба) с описанием того, что это такое. В этом случае нажмите «Продолжить» (и вы больше никогда этого не увидите). Вот как выглядит этот одноразовый экран:

Подготовка и подключение к Cloud Shell займет всего несколько минут.

Эта виртуальная машина оснащена всеми необходимыми инструментами разработки. Он предлагает постоянный домашний каталог объемом 5 ГБ и работает в Google Cloud, что значительно повышает производительность сети и аутентификацию. Большую часть, если не всю, работу в этой лаборатории кода можно выполнить с помощью просто браузера или Chromebook.

После подключения к Cloud Shell вы увидите, что вы уже прошли аутентификацию и что для проекта уже установлен идентификатор вашего проекта.

2. Выполните следующую команду в Cloud Shell, чтобы подтвердить, что вы прошли аутентификацию:

gcloud auth list

Вывод команды

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

Примечание. Инструмент командной строки gcloud — это мощный и унифицированный инструмент командной строки в Google Cloud. Он предустановлен в Cloud Shell. Вы заметите поддержку завершения табуляции. Дополнительную информацию см. в обзоре инструмента командной строки gcloud .

3. Выполните следующую команду в Cloud Shell, чтобы убедиться, что команда gcloud знает о вашем проекте:

gcloud config list project

Вывод команды

[core]
project = <PROJECT_ID>

Если это не так, вы можете установить это с помощью этой команды:

gcloud config set project <PROJECT_ID>

Вывод команды

Updated property [core/project].

3. Создайте приложение ASP.NET Core в Cloud Shell.

В командной строке Cloud Shell вы можете убедиться, что инструмент командной строки dotnet уже установлен, перечислив установленные пакеты SDK для .NET:

dotnet --list-sdks

Затем создайте новый скелет веб-приложения ASP.NET Core с целевой платформой netcoreapp3.1 :

dotnet new mvc -o HelloWorldAspNetCore -f netcoreapp3.1

Это должно создать проект и восстановить его зависимости. Вы должны увидеть сообщение, подобное приведенному ниже.

Restore completed in 11.44 sec for HelloWorldAspNetCore.csproj.

Restore succeeded.

4. Запустите приложение ASP.NET Core.

Мы почти готовы запустить наше приложение. Перейдите в папку приложения.

cd HelloWorldAspNetCore

Наконец, запустите приложение.

dotnet run --urls=http://localhost:8080

Приложение начинает прослушивать порт 8080.

Hosting environment: Production
Content root path: /home/atameldev/HelloWorldAspNetCore
Now listening on: http://[::]:8080
Application started. Press Ctrl+C to shut down.

Чтобы убедиться, что приложение работает, нажмите кнопку веб-предварительного просмотра в правом верхнем углу и выберите «Просмотр на порту 8080».

Вы увидите веб-страницу ASP.NET Core по умолчанию:

Убедившись, что приложение запущено, нажмите Ctrl+C, чтобы закрыть приложение.

5. Опубликуйте приложение ASP.NET Core.

Теперь опубликуйте приложение, чтобы получить автономную DLL, с помощью команды dotnet publish .

dotnet publish -c Release

При запуске publish в конце процесса отображаются некоторые сообщения с успешно опубликованной DLL.

...
  HelloWorldAspNetCore -> /home/atameldev/HelloWorldAspNetCore/bin/Release/netcoreapp3.1/HelloWorldAspNetCore.dll
  HelloWorldAspNetCore -> /home/atameldev/HelloWorldAspNetCore/bin/Release/netcoreapp3.1/HelloWorldAspNetCore.Views.dll
  HelloWorldAspNetCore -> /home/atameldev/HelloWorldAspNetCore/bin/Release/netcoreapp3.1/publish/

6. Создайте гибкий файл app.yaml для App Engine.

Файл app.yaml описывает, как развернуть приложение в App Engine, в данном случае в гибкой среде App Engine.

Сначала перейдите в папку publish . Он должен находиться в папке bin/Release , но точный путь зависит от версии .NET:

cd bin/Release/netcoreapp3.1/publish/

Создайте файл app.yaml внутри папки publish :

cat <<EOT >> app.yaml
env: flex
runtime: aspnetcore
EOT

Обратите внимание, что в файле app.yaml среда указана как flex , а среда выполнения — как aspnetcore .

7. Гибкое развертывание в App Engine

Вы готовы гибко развернуть свое приложение в App Engine с помощью gcloud . Внутри каталога publish выполните следующее:

gcloud app deploy --version v0

Во время развертывания вас могут попросить выбрать регион для вашего приложения. Выберите регион, в котором вы хотите, чтобы ваше приложение работало.

Please choose a region for your application. After choosing a region, 
you cannot change it. Which region would you like to choose?
 [1] europe-west   (supports standard and flexible)
 [2] us-central    (supports standard and flexible)
 [3] us-east1      (supports standard and flexible)
 [4] asia-northeast1 (supports standard and flexible)
 [5] cancel

Примечание

Первое развертывание может занять несколько минут. Это связано с тем, что гибкая среда App Engine автоматически подготавливает для вас виртуальную машину Google Compute Engine, затем устанавливает приложение и запускает его. Если время развертывания истекло, сообщите об этом преподавателю.

Это создаст образ вашего приложения в облаке, сохранит его в реестре контейнеров Google и развернет в App Engine. Во время развертывания вы можете увидеть, как создается образ контейнера:

Operation completed over 1 objects/571.8 KiB.
BUILD
Step #0: Pulling image: gcr.io/gcp-runtimes/aspnetcorebuild@sha256:d7b7975acb374fc3a9655a4e529993e6270cfa78023885684626528bc379f8eb
Step #0: sha256:d7b7975acb374fc3a9655a4e529993e6270cfa78023885684626528bc379f8eb: Pulling from gcp-runtimes/aspnetcorebuild

В конце вы должны увидеть, что приложение развернуто.

...
Deployed service [default] to [https://<project-id>.appspot.com]

После развертывания приложения посетите его, открыв URL-адрес http://<project-id>.appspot.com в своем веб-браузере.

Примечание

Если вы не помните свой project-id , обратитесь к разделу «Настройка и требования» или проверьте журналы развертывания, чтобы найти что-то похожее на это:

Deployed service [default] to [https://<project-id>.appspot.com]

Примечание

При желании вы можете вместо этого приобрести и использовать доменное имя верхнего уровня для своего приложения или использовать уже зарегистрированное доменное имя.

Вы увидите веб-страницу ASP.NET Core по умолчанию на новой вкладке.

Вы также можете просмотреть образ контейнера, созданный для вас в облаке. В облачной консоли перейдите в «Реестр контейнеров» > «Изображения», а затем в папке appengine вы должны увидеть образ вашего приложения.

8. Разверните новую версию вашего сервиса.

В какой-то момент приложение, которое вы развернули в рабочей среде, потребует исправления ошибок или дополнительных функций. App Engine поможет вам развернуть новую версию в рабочей среде, не затрагивая при этом ваших пользователей.

Во-первых, давайте изменим приложение. Откройте редактор кода из Cloud Shell.

Перейдите к Index.cshtml в папке Views/Home HelloWorldAspNetCore и обновите сообщение по умолчанию следующим образом:

Learn about <a href="https://docs.microsoft.com/aspnet/core">building Web apps with ASP.NET Core on Google Cloud Platform!

Сохраните изменения и вернитесь в Cloud Shell. Внутри HelloWorldAspNetCore, опубликуйте приложение, чтобы получить автономную DLL.

dotnet publish -c Release

Перейдите в каталог публикации.

cd bin/Release/netcoreapp3.1/publish/

Теперь вы можете развернуть новую версию своего приложения (в данном случае v1 ).

gcloud app deploy --version v1

После развертывания вы можете перейти в раздел «Версии App Engine» Google Cloud Console, чтобы увидеть новую версию вашего приложения, обслуживающую весь трафик с новым сообщением.

9. Дашборды и разделение трафика

В App Engine в разделе «Панель мониторинга» вы можете увидеть несколько панелей мониторинга вашего приложения по задержке, процессору и т. д. Изучите их самостоятельно.

В разделе «Версии» вы можете увидеть развернутые версии вашего приложения и разделить трафик между разными версиями в разделе «Разделение трафика». Давайте разделим трафик между двумя версиями:

10. Поздравляем!

C -подборка

Пришло время закрыть приложение, чтобы сэкономить на расходах и стать в целом хорошим гражданином облака.

Перейдите в раздел версий App Engine.

Выберите версию и остановите ее.

После остановки версии резервные экземпляры будут удалены, и вы увидите, что количество экземпляров упадет до нуля.

Что мы рассмотрели

Там! Вы создали приложение ASP.NET Core, упаковали его как контейнер Docker и развернули в Google App Engine Flexible.

• Как упаковать простое приложение ASP.NET Core в контейнер Docker.
• Как развернуть простое приложение ASP.NET Core в App Engine.

Следующие шаги

• Узнайте больше о Windows в Google Cloud Platform .
• Узнайте больше о .NET на Google Cloud Platform .
• Узнайте больше о SQL Server на Google Cloud Platform .
• Узнайте больше об облачных инструментах для Visual Studio .
• Узнайте больше об облачных инструментах для PowerShell .

Лицензия

Эта работа доступна под лицензией Creative Commons Attribution 2.0 Generic License.