1. Обзор
Развертывание веб-приложения в первый раз может быть пугающим. Даже после первого развертывания, если процесс слишком трудоемкий, вы можете избегать развертывания новых версий своего приложения. Непрерывное развертывание позволяет автоматически развертывать изменения в приложении.
В этой лабораторной работе вы напишете веб-приложение и настроите Cloud Run для автоматического развертывания приложения при изменении его исходного кода. Затем вы изменяете приложение и развертываете его снова.
Что вы узнаете
- Как написать веб-приложение с помощью редактора Cloud Shell
- Храните код приложения в GitHub
- Автоматически развертывать приложение в Cloud Run
- Как добавить генеративный ИИ в приложение с помощью Vertex AI
2. Требования
- Если у вас нет аккаунта Google, создайте его.
- Используйте личный аккаунт вместо рабочего или учебного. В рабочих и учебных аккаунтах могут действовать ограничения, которые не позволят вам включить API, необходимые для этой лабораторной работы.
- Если у вас нет аккаунта GitHub, создайте его.
- Если у вас уже есть аккаунт GitHub, используйте его. GitHub с большей вероятностью заблокирует новый аккаунт как спам.
- Настройте двухфакторную аутентификацию в аккаунте GitHub, чтобы снизить вероятность того, что он будет помечен как спам.
3. Настройка проекта
- Войдите в консоль Google Cloud.
- Включите оплату в Cloud Console.
- Выполнение этой лабораторной работы должно стоить менее 1 доллара США в ресурсах Cloud.
- Чтобы избежать дальнейших расходов, удалите ресурсы, следуя инструкциям в конце этой практической работы.
- Новые пользователи могут воспользоваться бесплатной пробной версией с бонусом в размере 300 долларов США.
- Собираетесь на мероприятие Gen AI for Devs? Вы можете получить бонус в размере 1 доллара США.
- Создайте новый проект или выберите существующий.
- Убедитесь, что платежные функции включены в разделе My projects (Мои проекты) в Cloud Billing
- .
- Если в столбце
Billing accountдля нового проекта указаноBilling is disabled:- Нажмите на значок с тремя точками в столбце
Actions. - Нажмите Изменить платежные данные.
- Выберите платежный аккаунт, который хотите использовать.
- Нажмите на значок с тремя точками в столбце
- Если вы участвуете в мероприятии Gen AI for Devs, аккаунт, скорее всего, будет называться Google Cloud Platform Trial Billing Account.
- Если в столбце
4. Открыть редактор Cloud Shell
- Перейдите в редактор Cloud Shell.
- Если терминал не появился внизу экрана, откройте его:
- Нажмите на значок меню в виде трех горизонтальных полосок
. - Выберите Терминал.
- Нажмите New Terminal (Новый терминал).

- Нажмите на значок меню в виде трех горизонтальных полосок
- В терминале задайте проект с помощью следующей команды:
- Формат:
gcloud config set project [PROJECT_ID] - Пример:
gcloud config set project lab-project-id-example - Если вы не помните идентификатор проекта:
- Чтобы посмотреть список всех идентификаторов проектов, выполните следующую команду:
gcloud projects list | awk '/PROJECT_ID/{print $2}'

- Чтобы посмотреть список всех идентификаторов проектов, выполните следующую команду:
- Формат:
- Если появится запрос на авторизацию, нажмите Авторизовать.

- Вы увидите следующее сообщение:
Если вы видите сообщениеUpdated property [core/project].
WARNINGи вопросDo you want to continue (Y/N)?, то, скорее всего, вы неправильно ввели идентификатор проекта. НажмитеN, затемEnterи попробуйте снова выполнить командуgcloud config set project.
5. Как включить API
В терминале включите API:
gcloud services enable \
run.googleapis.com \
cloudbuild.googleapis.com \
aiplatform.googleapis.com
Выполнение этой команды может занять несколько минут, но в конечном итоге должно появиться сообщение об успешном завершении, подобное следующему:
Operation "operations/acf.p2-73d90d00-47ee-447a-b600" finished successfully.
6. Настроить Git
- Укажите глобальный адрес электронной почты пользователя git:
git config --global user.email "you@example.com" - Установите глобальное имя пользователя git:
git config --global user.name "Your Name" - Установите глобальную ветку git по умолчанию на
main:git config --global init.defaultBranch main
7. Напишите код
Чтобы написать приложение на Python, выполните следующие действия:
- Перейдите в домашний каталог:
cd ~ - Создайте каталог
codelab-genai:mkdir codelab-genai - Перейдите в каталог
codelab-genai:cd codelab-genai - Создайте файл
main.py:touch main.py - Создайте файл
requirements.txtсо списком зависимостей:cat > requirements.txt << EOF Flask==3.0.0 gunicorn==20.1.0 EOF - Откройте файл
main.pyв редакторе Cloud Shell: В верхней части экрана появится пустой файл. Здесь вы можете изменить файлcloudshell edit main.pymain.py.
- Скопируйте следующий код и вставьте его в открытый файл
main.py: Через несколько секунд редактор Cloud Shell автоматически сохранит ваш код. Этот код отвечает на HTTP-запросы приветствием "Hello world!".import os from flask import Flask app = Flask(__name__) @app.route("/") def hello_world(): return f"Hello world!" if __name__ == "__main__": app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
Ваш первоначальный код для вашего приложения готов и готов к сохранению в системе управления версиями.
8. Создать хранилище
- Вернитесь в терминал Cloud Shell в нижней части экрана.
- Убедитесь, что вы находитесь в нужном каталоге:
cd ~/codelab-genai - Инициализируйте хранилище Git
git init -b main - Войдите в GitHub CLI.
Нажмитеgh auth loginEnter, чтобы принять параметры по умолчанию, и следуйте инструкциям в инструменте GitHub CLI, в том числе:- В какой аккаунт вы хотите войти?
GitHub.com - What is your preferred protocol for Git operations on this host?
HTTPS - Как выполнить аутентификацию Git с помощью учетных данных GitHub?
Y(Пропустите этот шаг, если такого варианта нет.) - How would you like to authenticate GitHub CLI?
Login with a web browser - Скопируйте одноразовый код
- Откройте страницу https://github.com/login/device.
- Вставьте одноразовый код
- Нажмите Authorize github (Авторизовать GitHub).
- Завершите вход в аккаунт
- В какой аккаунт вы хотите войти?
- Подтвердите, что вы вошли в аккаунт:
Если вы успешно вошли в систему, должно появиться ваше имя пользователя GitHub.gh api user -q ".login" - Создайте переменную
GITHUB_USERNAMEGITHUB_USERNAME=$(gh api user -q ".login") - Убедитесь, что вы создали переменную среды:
Если переменная создана успешно, вы увидите свое имя пользователя GitHub.echo ${GITHUB_USERNAME} - Создайте пустое хранилище GitHub с названием
codelab-genai: Если вы видите сообщение об ошибке:gh repo create codelab-genai --private У вас уже есть хранилище с названиемGraphQL: Name already exists on this account (createRepository)
codelab-genai. Чтобы продолжить работу с этим руководством, выберите один из двух вариантов:- Как удалить существующее хранилище GitHub
- Создайте хранилище с другим названием и не забудьте изменить его в следующих командах.
- Добавьте хранилище
codelab-genaiв качестве удаленногоorigin:git remote add origin https://github.com/${GITHUB_USERNAME}/codelab-genai
9. Поделитесь кодом
- Убедитесь, что вы находитесь в правильном каталоге:
cd ~/codelab-genai - Добавьте все файлы из текущего каталога в этот коммит:
git add . - Создайте первый коммит:
git commit -m "add http server" - Отправьте фиксацию в ветку
mainрепозиторияorigin:git push -u origin main
Вы можете выполнить эту команду и перейти по полученному URL, чтобы посмотреть код приложения на GitHub:
echo -e "\n\nTo see your code, visit this URL:\n \
https://github.com/${GITHUB_USERNAME}/codelab-genai/blob/main/main.py \n\n"
10. Как настроить автоматическое развертывание
- Не закрывайте вкладку редактора Cloud Shell. Мы вернемся к этой вкладке позже.
- В новой вкладке откройте страницу Cloud Run.
- Выберите нужный проект Google Cloud в консоли
. - Нажмите CONNECT REPO (Подключить репозиторий).
- Нажмите SET UP WITH CLOUD BUILD (НАСТРОИТЬ С ПОМОЩЬЮ CLOUD BUILD).
- В качестве поставщика хранилища выберите GitHub.
- Если вы не вошли в аккаунт GitHub в браузере, войдите в него, используя свои учетные данные.
- Нажмите Выполнить аутентификацию, а затем – Продолжить.
- После входа на странице Cloud Run появится сообщение Приложение GitHub не установлено ни в одном из ваших хранилищ.
- Нажмите кнопку INSTALL GOOGLE CLOUD BUILD (Установить Google Cloud Build).
- На странице Installation Setup (Настройка установки) выберите Only select repositories (Только выбранные хранилища) и укажите хранилище codelab-genai, созданное с помощью CLI.
- Нажмите Установить.
- Примечание. Если у вас много хранилищ GitHub, загрузка может занять несколько минут.
- В качестве хранилища выберите
your-user-name/codelab-genai.- Если хранилища нет, нажмите на ссылку Manage Connected Repositories (Управление подключенными хранилищами).
- В поле Branch (Ветвь) оставьте значение
^main$. - Нажмите Go, Node.js, Python, Java, .NET Core, Ruby or PHP via Google Cloud's buildpacks (Go, Node.js, Python, Java, .NET Core, Ruby или PHP через пакеты сборки Google Cloud).
- Остальные поля (
Build context directory,EntrypointиFunction target) оставьте без изменений.
- Остальные поля (
- Нажмите Сохранить.
- В качестве поставщика хранилища выберите GitHub.
- Прокрутите вниз до раздела Аутентификация.
- Нажмите Разрешить вызовы без аутентификации.
- Нажмите Создать.
Когда сборка завершится (это займет несколько минут), выполните следующую команду и перейдите по полученному URL, чтобы посмотреть на работающее приложение:
echo -e "\n\nOnce the build finishes, visit your live application:\n \
"$( \
gcloud run services list | \
grep codelab-genai | \
awk '/URL/{print $2}' | \
head -1 \
)" \n\n"
11. Изменить код
Вернуться в редактор Cloud Shell
Если у вас уже открыт редактор Cloud Shell, вы можете пропустить эти шаги.
- Перейдите в редактор Cloud Shell.
- Если терминал не появился внизу экрана, откройте его:
- Нажмите на значок меню в виде трех горизонтальных полосок
. - Выберите Терминал.
- Нажмите New Terminal (Новый терминал).

- Нажмите на значок меню в виде трех горизонтальных полосок
- В терминале задайте проект с помощью следующей команды:
- Формат:
gcloud config set project [PROJECT_ID] - Пример:
gcloud config set project lab-project-id-example - Если вы не помните идентификатор проекта:
- Чтобы посмотреть список всех идентификаторов проектов, выполните следующую команду:
gcloud projects list | awk '/PROJECT_ID/{print $2}'

- Чтобы посмотреть список всех идентификаторов проектов, выполните следующую команду:
- Формат:
- Если появится запрос на авторизацию, нажмите Авторизовать.

- Вы увидите следующее сообщение:
Если вы видите сообщениеUpdated property [core/project].
WARNINGи вопросDo you want to continue (Y/N)?, то, скорее всего, вы неправильно ввели идентификатор проекта. НажмитеN, затемEnterи попробуйте снова выполнить командуgcloud config set project.
Как добавить Vertex AI в приложение
- Вернитесь в терминал Cloud Shell в нижней части экрана.
- Убедитесь, что вы находитесь в нужном каталоге:
cd ~/codelab-genai - Добавьте зависимость Vertex AI SDK к существующим зависимостям:
sed -i -e '$agoogle-cloud-aiplatform==1.59.0' requirements.txt - Добавьте библиотеку google auth к существующим зависимостям:
sed -i -e '$agoogle-auth==2.32.0' requirements.txt - Повторно открыть
main.pyв редакторе Cloud Shellcloudshell edit main.py - Замените код в файле
main.pyна следующий:import os from flask import Flask, request import google.auth import vertexai from vertexai.generative_models import GenerativeModel _, project = google.auth.default() app = Flask(__name__) @app.route("/") def hello_world(): vertexai.init(project=project, location="us-central1") model = GenerativeModel("gemini-1.5-flash") animal = request.args.get("animal", "dog") prompt = f"Give me 10 fun facts about {animal}. Return this as html without backticks." response = model.generate_content(prompt) return response.text if __name__ == "__main__": app.run(debug=True, host="0.0.0.0", port=int(os.environ.get("PORT", 8080)))
12. Развернуть повторно
- Убедитесь, что вы находитесь в правильном каталоге в Cloud Shell:
cd ~/codelab-genai - Чтобы зафиксировать новую версию приложения в локальном хранилище Git, выполните следующие команды:
git add . git commit -m "add latest changes" - Отправьте изменения в GitHub:
git push - После завершения сборки выполните эту команду и перейдите к развернутому приложению:
echo -e "\n\nOnce the build finishes, visit your live application:\n \ "$( \ gcloud run services list | \ grep codelab-genai | \ awk '/URL/{print $2}' | \ head -1 \ )" \n\n"
Прежде чем вы увидите изменения, может пройти несколько минут.
Историю всех версий можно посмотреть здесь: https://console.cloud.google.com/run/detail/us-central1/codelab-genai/revisions.
13. (Необязательно) Проверьте использование Vertex AI
Как и в случае с другими сервисами Google Cloud, вы можете проводить аудит операций Vertex AI. Журналы аудита помогают ответить на вопросы "Кто, что, где и когда сделал?". Журналы аудита администратора для Vertex AI включены по умолчанию. Чтобы проверять запросы на создание контента, включите журналы аудита доступа к данным.
- В консоли Google Cloud перейдите на страницу Журналы аудита.
Если вы ищете эту страницу с помощью строки поиска, выберите результат с подзаголовком IAM и администрирование. - Убедитесь, что существующий проект Google Cloud – это тот, в котором вы создаете приложение Cloud Run.
- В таблице Конфигурация журналов аудита доступа к данным найдите и выберите
Vertex AI APIв столбце "Сервис". - На вкладке Log Types (Типы журналов) выберите типы журналов аудита доступа к данным
Admin readиData read. - Нажмите Сохранить.
После этого вы сможете просматривать журналы аудита для каждого вызова приложения. Чтобы посмотреть журналы аудита с подробными сведениями о вызовах, выполните следующие действия:
- Вернитесь в развернутое приложение и обновите страницу, чтобы запустить журнал.
- В консоли Google Cloud перейдите на страницу Log Explorer:
- В окне запроса введите:
LOG_ID("cloudaudit.googleapis.com%2Fdata_access") protoPayload.serviceName="aiplatform.googleapis.com" - Нажмите Выполнить запрос.
Журналы аудита фиксируют использование Vertex AI API, но не позволяют просматривать данные, связанные с рабочей нагрузкой, например запросы или сведения об ответах.
14. Как повысить наблюдаемость рабочей нагрузки ИИ (необязательно)
В журналах аудита не фиксируется информация, связанная с рабочей нагрузкой. Чтобы повысить наблюдаемость рабочих нагрузок, необходимо явно регистрировать эту информацию. Для этого можно использовать любой фреймворк ведения журналов. Ниже показано, как это сделать с помощью встроенного механизма ведения журналов Node.js.
- Повторно открыть
main.pyв редакторе Cloud Shellcloudshell edit ~/codelab-genai/main.py - После строки
import os(строка 1) добавьте следующие строки: Эти строки изменяют форматирование журналов Python по умолчанию на структурированное форматирование JSON, которое можно использовать в Google Cloud.import sys, json, logging class JsonFormatter(logging.Formatter): def format(self, record): json_log_object = { "severity": record.levelname, "message": record.getMessage(), } json_log_object.update(getattr(record, "json_fields", {})) return json.dumps(json_log_object) logger = logging.getLogger(__name__) sh = logging.StreamHandler(sys.stdout) sh.setFormatter(JsonFormatter()) logger.addHandler(sh) logger.setLevel(logging.DEBUG) - После строки, вызывающей
model.generate_content(prompt)(строка 34), добавьте следующие строки: Этот код выводит структурированную информацию о создании контента вjson_fields = {"prompt": prompt, "response": response.to_dict()} logger.debug("Content is generated", extra={"json_fields": json_fields})stdout, откуда она считывается агентом ведения журналов и передается в Cloud Logging. - Снова откройте Cloud Shell и введите следующую команду, чтобы убедиться, что вы находитесь в правильном каталоге:
cd ~/codelab-genai - Зафиксируйте изменения:
git commit -am "observe generated content" - Отправьте изменения в GitHub, чтобы запустить повторное развертывание измененной версии:
git push
После развертывания новой версии вы сможете просматривать сведения для отладки о вызовах Vertex AI.
Чтобы посмотреть журналы приложения, выполните следующие действия:
- В консоли Google Cloud перейдите на страницу Log Explorer:
- В окне запроса введите:
LOG_ID("run.googleapis.com%2Fstdout") severity=DEBUG - Нажмите Выполнить запрос.
В результате запроса будут показаны журналы с запросом и ответом Vertex AI, включая оценки безопасности, которые можно использовать для мониторинга методов обеспечения безопасности.
15. (Необязательно) Удаление ресурсов
Хотя Cloud Run не взимает плату, когда сервис не используется, с вас все равно может взиматься плата за хранение образа контейнера в Artifact Registry. Чтобы избежать дополнительных расходов, вы можете удалить облачный проект. После удаления облачного проекта оплата за все ресурсы, используемые в нем, перестанет взиматься.
При желании удалите проект:
gcloud projects delete $GOOGLE_CLOUD_PROJECT
Вы также можете удалить ненужные ресурсы с диска Cloud Shell. Вы можете:
- Удалите каталог проекта практической работы:
rm -rf ~/codelab-genai - Внимание! Это действие нельзя отменить. Если вы хотите удалить все данные в Cloud Shell, чтобы освободить место, удалите весь главный каталог. Убедитесь, что все нужные данные сохранены в другом месте.
sudo rm -rf $HOME
16. Поздравляю!
В этой практической работе вы написали веб-приложение и настроили Cloud Run для автоматического развертывания приложения при изменении его исходного кода. Затем вы изменили приложение и развернули его снова.
Если вам понравилась эта лабораторная работа, вы можете попробовать выполнить ее снова на другом языке программирования или фреймворке: