1. Обзор
Первое развертывание веб-приложения может быть пугающим. Если даже после первого развертывания этот процесс требует слишком много работы, вы можете избежать развертывания новых версий вашего приложения. Благодаря непрерывному развертыванию вы можете легко автоматически развертывать изменения вашего приложения.
В ходе этой лабораторной работы вы напишете веб-приложение и настроите Cloud Run для автоматического развертывания вашего приложения при внесении изменений в исходный код вашего приложения. Затем вы изменяете свое приложение и развертываете его снова.
Что вы узнаете
- Напишите веб-приложение с помощью редактора Cloud Shell.
- Сохраните код приложения на GitHub.
- Автоматически развертывайте свое приложение в Cloud Run
- Добавьте генеративный ИИ в свое приложение с помощью Genkit
- Управляйте подсказками LLM с помощью библиотеки dotprompt.
2. Предварительные условия
- Если у вас еще нет учетной записи Google, вам необходимо создать учетную запись Google .
- Используйте личную учетную запись вместо рабочей или учебной учетной записи. Рабочие и учебные учетные записи могут иметь ограничения, не позволяющие вам включить API, необходимые для этой лабораторной работы.
- Если у вас еще нет учетной записи GitHub, вам необходимо создать учетную запись GitHub.
- Используйте существующую учетную запись GitHub, если она у вас есть. GitHub с большей вероятностью заблокирует новую учетную запись как спам.
- Настройте двухфакторную аутентификацию в своей учетной записи GitHub, чтобы снизить вероятность того, что ваша учетная запись будет помечена как спам.
3. Настройка проекта
- Войдите в Google Cloud Console .
- Включите биллинг в Cloud Console.
- Завершение этой лабораторной работы должно стоить менее 1 доллара США в облачных ресурсах.
- Вы можете выполнить действия, описанные в конце этого практического занятия, чтобы удалить ресурсы и избежать дальнейших расходов.
- Новые пользователи имеют право на бесплатную пробную версию стоимостью 300 долларов США .
- Посещаете мероприятие Gen AI for Devs? Может быть доступен кредит в размере 1 доллара США .
- Создайте новый проект или повторно используйте существующий проект.
- Убедитесь, что оплата включена в разделе «Мои проекты» в Cloud Billing.
- Если в вашем новом проекте в столбце
Billing account
указано,Billing is disabled
:- Нажмите на три точки в столбце «
Actions
. - Нажмите Изменить платеж.
- Выберите платежный аккаунт, который вы хотите использовать.
- Нажмите на три точки в столбце «
- Если вы посещаете мероприятие Gen AI for Devs, учетная запись, скорее всего, будет называться Пробная учетная запись Google Cloud Platform.
- Если в вашем новом проекте в столбце
4. Откройте редактор Cloud Shell.
- Перейдите в редактор Cloud Shell.
- Если терминал не отображается в нижней части экрана, откройте его:
- Нажмите на гамбургер-меню
- Нажмите Терминал
- Нажмите «Новый терминал».
- Нажмите на гамбургер-меню
- В терминале настройте свой проект с помощью этой команды:
- Формат:
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. Напишите свой код
Чтобы написать приложение на Node.js:
- Перейдите в домашний каталог:
cd ~
- Создайте каталог
codelab-genai
:mkdir codelab-genai
- Перейдите в каталог
codelab-genai
:cd codelab-genai
- Создайте файл
index.js
:touch index.js
- Создайте файл
package.json
:npm init es6 -y
- Добавить
express
как зависимостьnpm install express
- Добавьте файл
.gitignore
, чтобы предотвратить фиксациюnode_modules
echo node_modules/ >> .gitignore
- Откройте файл
index.js
в редакторе Cloud Shell: Пустой файл должен появиться в верхней части экрана. Здесь вы можете редактировать файлcloudshell edit index.js
index.js
. - Скопируйте следующий код и вставьте его в открытый файл
index.js
: Через несколько секунд редактор Cloud Shell автоматически сохранит ваш код. Этот код отвечает на http-запросы фразой «Hello world!». приветствие.import express from 'express'; const app = express(); app.get('/', async (req, res) => { res.send('Hello world!'); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
Ваш исходный код вашего приложения готов и готов к хранению в системе контроля версий.
8. Создайте репозиторий
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Инициализируйте свой git-репозиторий
git init -b main
- Войдите в интерфейс командной строки GitHub.
Нажмитеgh auth login
Enter
, чтобы принять параметры по умолчанию, и следуйте инструкциям инструмента GitHub CLI, включая:- В какой аккаунт вы хотите войти?
GitHub.com
- Какой протокол вы предпочитаете для операций Git на этом хосте?
HTTPS
- Аутентифицировать Git с помощью своих учетных данных GitHub?
Y
(пропустите, если этот пункт не отображается.) - Как бы вы хотели аутентифицировать GitHub CLI?
Login with a web browser
- Скопируйте свой одноразовый код
- Откройте https://github.com/login/device.
- Вставьте свой одноразовый код
- Нажмите «Авторизовать github».
- Завершите вход
- В какой аккаунт вы хотите войти?
- Подтвердите, что вы вошли в систему:
Если вы успешно вошли в систему, должно быть выведено ваше имя пользователя GitHub.gh api user -q ".login"
- Создайте переменную
GITHUB_USERNAME
.GITHUB_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/index.js \n\n"
10. Настройте автоматическое развертывание
- Оставьте вкладку «Редактор Cloud Shell» открытой. К этой вкладке мы вернемся позже.
- В новой вкладке перейдите на страницу Cloud Run.
- Выберите правильный проект Google Cloud в консоли.
- Нажмите ПОДКЛЮЧИТЬ РЕПО.
- Нажмите НАСТРОЙКА С ПОМОЩЬЮ CLOUD BUILD.
- Выберите GitHub в качестве поставщика репозитория.
- Если вы не вошли в свою учетную запись GitHub в браузере, войдите в систему, используя свои учетные данные.
- Нажмите «Аутентификация» , а затем нажмите « Продолжить» .
- После входа в систему на странице Cloud Run вы увидите сообщение о том, что приложение GitHub не установлено ни в одном из ваших репозиториев.
- Нажмите кнопку «УСТАНОВИТЬ GOOGLE CLOUD BUILD» .
- На странице «Настройка установки» выберите «Только выбирать репозитории» и выберите репозиторий codelab-genai , который вы создали с помощью CLI.
- Нажмите «Установить».
- Примечание. Если у вас много репозиториев GitHub, загрузка может занять несколько минут.
- Выберите
your-user-name/codelab-genai
в качестве репозитория.- Если репозиторий отсутствует, щелкните ссылку «Управление подключенными репозиториями» .
- Оставьте ветку как
^main$
- Выберите 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.
- Если терминал не отображается в нижней части экрана, откройте его:
- Нажмите на гамбургер-меню
- Нажмите Терминал
- Нажмите «Новый терминал».
- Нажмите на гамбургер-меню
- В терминале настройте свой проект с помощью этой команды:
- Формат:
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
.
Добавьте Genkit и Vertex AI в свое приложение.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Установите Node.js Genkit SDK:
npm install @genkit-ai/ai
- Установите Node.js Genkit SDK для Vertex AI:
npm install @genkit-ai/vertexai
- Снова откройте
index.js
в редакторе Cloud Shell.cloudshell edit ~/codelab-genai/index.js
- Замените код в файле
index.js
на:import express from 'express'; const app = express(); import { genkit } from 'genkit'; import { gemini15Flash, vertexAI } from '@genkit-ai/vertexai'; const ai = genkit({ plugins: [ vertexAI({ location: 'us-central1' }), ], }); app.get('/', async (req, res) => { const animal = req.query.animal || 'dog'; const prompt = `Give me 10 fun facts about ${animal}. Return this as html without backticks.` const llmResponse = await ai.generate({ model: gemini15Flash, prompt: prompt, }); const html = llmResponse.text; res.send(html); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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.
12. (Необязательно) Используйте файлы .prompt с Genkit.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Создайте папку
prompts
для хранения подсказок:mkdir prompts
- Создайте файл
animal-facts.prompt
, чтобы создать первое приглашение:touch prompts/animal-facts.prompt
- Откройте файл
animal-facts.prompt
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/prompts/animal-facts.prompt
- Отредактируйте
animal-facts.prompt
и вставьте в него следующий код:--- model: vertexai/gemini-1.5-flash input: schema: animal: string --- Give me 10 fun facts about {{animal}}. Return the results as HTML without markdown backticks.
- Откройте файл
index.js
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/index.js
- Замените код в файле
index.js
на:import express from 'express'; const app = express(); import { genkit } from 'genkit'; import { vertexAI } from '@genkit-ai/vertexai'; const ai = genkit({ plugins: [ vertexAI({ location: 'us-central1' }), ], }); app.get('/', async (req, res) => { const animal = req.query.animal || 'dog'; const animalPrompt = ai.prompt('animal-facts'); const llmResponse = await animalPrompt({animal}); const html = llmResponse.text; res.send(html); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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. (Необязательно) Используйте системные подсказки.
На этом шаге предполагается, что вы уже добавили файлы .prompt
на предыдущем шаге.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Откройте файл
animal-facts.prompt
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/prompts/animal-facts.prompt
- Отредактируйте
animal-facts.prompt
и вставьте в него следующий код:--- model: vertexai/gemini-1.5-flash config: temperature: 0.9 input: schema: animal: string --- role "system" The user should have submitted an animal. If the user requests anything besides animal fun facts, respond in a kind and firm manner that you only provide information about fun facts. Give the user 10 fun facts about the animal the user provided. All responses should be valid HTML without markdown backticks. role "user" {{animal}}
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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.
14. Поздравления
В ходе этой лабораторной работы вы написали веб-приложение и настроили Cloud Run для автоматического развертывания вашего приложения при внесении изменений в исходный код вашего приложения. Затем вы изменили свое приложение и снова развернули его.
Если вам понравилась эта лабораторная работа, вы можете попробовать ее еще раз на другом языке программирования или в другой среде:
Вот несколько вариантов продолжения обучения:
- Документация Genkit: начало работы
- Codelab для добавления наблюдаемости в ваше приложение Node.js: практические методы наблюдения для приложения генеративного ИИ на Javascript
- Codelab для добавления внешнего интерфейса в ваше приложение с помощью Next.js: автоматическое развертывание веб-приложения Generative AI Next.js из системы управления версиями в облако
- Codelab, чтобы показать, как использовать вызов функций: Как использовать вызов функций Gemini с Cloud Run
- Codelab для использования искусственного интеллекта для обработки видеоконтента: как использовать Cloud Run Jobs Video Intelligence API для пошаговой обработки видео
1. Обзор
Первое развертывание веб-приложения может быть пугающим. Если даже после первого развертывания этот процесс требует слишком много работы, вы можете избежать развертывания новых версий вашего приложения. Благодаря непрерывному развертыванию вы можете легко автоматически развертывать изменения вашего приложения.
В ходе этой лабораторной работы вы напишете веб-приложение и настроите Cloud Run для автоматического развертывания вашего приложения при внесении изменений в исходный код вашего приложения. Затем вы изменяете свое приложение и развертываете его снова.
Что вы узнаете
- Напишите веб-приложение с помощью редактора Cloud Shell.
- Сохраните код приложения на GitHub.
- Автоматически развертывайте свое приложение в Cloud Run
- Добавьте генеративный ИИ в свое приложение с помощью Genkit
- Управляйте подсказками LLM с помощью библиотеки dotprompt.
2. Предварительные условия
- Если у вас еще нет учетной записи Google, вам необходимо создать учетную запись Google .
- Используйте личную учетную запись вместо рабочей или учебной учетной записи. Рабочие и учебные учетные записи могут иметь ограничения, не позволяющие вам включить API, необходимые для этой лабораторной работы.
- Если у вас еще нет учетной записи GitHub, вам необходимо создать учетную запись GitHub.
- Используйте существующую учетную запись GitHub, если она у вас есть. GitHub с большей вероятностью заблокирует новую учетную запись как спам.
- Настройте двухфакторную аутентификацию в своей учетной записи GitHub, чтобы снизить вероятность того, что ваша учетная запись будет помечена как спам.
3. Настройка проекта
- Войдите в Google Cloud Console .
- Включите биллинг в Cloud Console.
- Завершение этой лабораторной работы должно стоить менее 1 доллара США в облачных ресурсах.
- Вы можете выполнить действия, описанные в конце этого практического занятия, чтобы удалить ресурсы и избежать дальнейших расходов.
- Новые пользователи имеют право на бесплатную пробную версию стоимостью 300 долларов США .
- Посещаете мероприятие Gen AI for Devs? Может быть доступен кредит в размере 1 доллара США .
- Создайте новый проект или повторно используйте существующий проект.
- Убедитесь, что оплата включена в разделе «Мои проекты» в Cloud Billing.
- Если в вашем новом проекте в столбце
Billing account
указано,Billing is disabled
:- Нажмите на три точки в столбце «
Actions
. - Нажмите Изменить платеж.
- Выберите платежный аккаунт, который вы хотите использовать.
- Нажмите на три точки в столбце «
- Если вы посещаете мероприятие Gen AI for Devs, учетная запись, скорее всего, будет называться Пробная учетная запись Google Cloud Platform.
- Если в вашем новом проекте в столбце
4. Откройте редактор Cloud Shell.
- Перейдите в редактор Cloud Shell.
- Если терминал не отображается в нижней части экрана, откройте его:
- Нажмите на гамбургер-меню
- Нажмите Терминал
- Нажмите «Новый терминал».
- Нажмите на гамбургер-меню
- В терминале настройте свой проект с помощью этой команды:
- Формат:
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. Напишите свой код
Чтобы написать приложение на Node.js:
- Перейдите в домашний каталог:
cd ~
- Создайте каталог
codelab-genai
:mkdir codelab-genai
- Перейдите в каталог
codelab-genai
:cd codelab-genai
- Создайте файл
index.js
:touch index.js
- Создайте файл
package.json
:npm init es6 -y
- Добавить
express
как зависимостьnpm install express
- Добавьте файл
.gitignore
, чтобы предотвратить фиксациюnode_modules
echo node_modules/ >> .gitignore
- Откройте файл
index.js
в редакторе Cloud Shell: Пустой файл должен появиться в верхней части экрана. Здесь вы можете редактировать файлcloudshell edit index.js
index.js
. - Скопируйте следующий код и вставьте его в открытый файл
index.js
: Через несколько секунд редактор Cloud Shell автоматически сохранит ваш код. Этот код отвечает на http-запросы фразой «Hello world!». приветствие.import express from 'express'; const app = express(); app.get('/', async (req, res) => { res.send('Hello world!'); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
Ваш исходный код вашего приложения готов и готов к хранению в системе контроля версий.
8. Создайте репозиторий
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Инициализируйте свой git-репозиторий
git init -b main
- Войдите в интерфейс командной строки GitHub.
Нажмитеgh auth login
Enter
, чтобы принять параметры по умолчанию, и следуйте инструкциям инструмента GitHub CLI, включая:- В какой аккаунт вы хотите войти?
GitHub.com
- Какой протокол вы предпочитаете для операций Git на этом хосте?
HTTPS
- Аутентифицировать Git с помощью своих учетных данных GitHub?
Y
(пропустите, если этот пункт не отображается.) - Как бы вы хотели аутентифицировать GitHub CLI?
Login with a web browser
- Скопируйте свой одноразовый код
- Откройте https://github.com/login/device.
- Вставьте свой одноразовый код
- Нажмите «Авторизовать github».
- Завершите вход
- В какой аккаунт вы хотите войти?
- Подтвердите, что вы вошли в систему:
Если вы успешно вошли в систему, должно быть выведено ваше имя пользователя GitHub.gh api user -q ".login"
- Создайте переменную
GITHUB_USERNAME
.GITHUB_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/index.js \n\n"
10. Настройте автоматическое развертывание
- Оставьте вкладку «Редактор Cloud Shell» открытой. К этой вкладке мы вернемся позже.
- В новой вкладке перейдите на страницу Cloud Run.
- Выберите правильный проект Google Cloud в консоли.
- Нажмите ПОДКЛЮЧИТЬ РЕПО.
- Нажмите НАСТРОЙКА С ПОМОЩЬЮ CLOUD BUILD.
- Выберите GitHub в качестве поставщика репозитория.
- Если вы не вошли в свою учетную запись GitHub в браузере, войдите в систему, используя свои учетные данные.
- Нажмите «Аутентификация» , а затем нажмите « Продолжить» .
- После входа в систему на странице Cloud Run вы увидите сообщение о том, что приложение GitHub не установлено ни в одном из ваших репозиториев.
- Нажмите кнопку «УСТАНОВИТЬ GOOGLE CLOUD BUILD» .
- На странице «Настройка установки» выберите «Только выбирать репозитории» и выберите репозиторий codelab-genai , который вы создали с помощью CLI.
- Нажмите «Установить».
- Примечание. Если у вас много репозиториев GitHub, загрузка может занять несколько минут.
- Выберите
your-user-name/codelab-genai
в качестве репозитория.- Если репозиторий отсутствует, щелкните ссылку «Управление подключенными репозиториями» .
- Оставьте ветку как
^main$
- Выберите 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.
- Если терминал не отображается в нижней части экрана, откройте его:
- Нажмите на гамбургер-меню
- Нажмите Терминал
- Нажмите «Новый терминал».
- Нажмите на гамбургер-меню
- В терминале настройте свой проект с помощью этой команды:
- Формат:
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
.
Добавьте Genkit и Vertex AI в свое приложение.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Установите Node.js Genkit SDK:
npm install @genkit-ai/ai
- Установите Node.js Genkit SDK для Vertex AI:
npm install @genkit-ai/vertexai
- Снова откройте
index.js
в редакторе Cloud Shell.cloudshell edit ~/codelab-genai/index.js
- Замените код в файле
index.js
на:import express from 'express'; const app = express(); import { genkit } from 'genkit'; import { gemini15Flash, vertexAI } from '@genkit-ai/vertexai'; const ai = genkit({ plugins: [ vertexAI({ location: 'us-central1' }), ], }); app.get('/', async (req, res) => { const animal = req.query.animal || 'dog'; const prompt = `Give me 10 fun facts about ${animal}. Return this as html without backticks.` const llmResponse = await ai.generate({ model: gemini15Flash, prompt: prompt, }); const html = llmResponse.text; res.send(html); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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.
12. (Необязательно) Используйте файлы .prompt с Genkit.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Создайте папку
prompts
для хранения подсказок:mkdir prompts
- Создайте файл
animal-facts.prompt
, чтобы создать первое приглашение:touch prompts/animal-facts.prompt
- Откройте файл
animal-facts.prompt
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/prompts/animal-facts.prompt
- Отредактируйте
animal-facts.prompt
и вставьте в него следующий код:--- model: vertexai/gemini-1.5-flash input: schema: animal: string --- Give me 10 fun facts about {{animal}}. Return the results as HTML without markdown backticks.
- Откройте файл
index.js
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/index.js
- Замените код в файле
index.js
на:import express from 'express'; const app = express(); import { genkit } from 'genkit'; import { vertexAI } from '@genkit-ai/vertexai'; const ai = genkit({ plugins: [ vertexAI({ location: 'us-central1' }), ], }); app.get('/', async (req, res) => { const animal = req.query.animal || 'dog'; const animalPrompt = ai.prompt('animal-facts'); const llmResponse = await animalPrompt({animal}); const html = llmResponse.text; res.send(html); }); const port = process.env.PORT || 8080; app.listen(port, () => { console.log(`codelab-genai: listening on port ${port}`); });
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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. (Необязательно) Используйте системные подсказки.
На этом шаге предполагается, что вы уже добавили файлы .prompt
на предыдущем шаге.
- Вернитесь к терминалу Cloud Shell в нижней части экрана.
- Убедитесь, что вы все еще находитесь в правильном каталоге:
cd ~/codelab-genai
- Откройте файл
animal-facts.prompt
в редакторе Cloud Shell:cloudshell edit ~/codelab-genai/prompts/animal-facts.prompt
- Отредактируйте
animal-facts.prompt
и вставьте в него следующий код:--- model: vertexai/gemini-1.5-flash config: temperature: 0.9 input: schema: animal: string --- role "system" The user should have submitted an animal. If the user requests anything besides animal fun facts, respond in a kind and firm manner that you only provide information about fun facts. Give the user 10 fun facts about the animal the user provided. All responses should be valid HTML without markdown backticks. role "user" {{animal}}
- Убедитесь, что вы по-прежнему находитесь в правильном каталоге 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.
14. Поздравления
В ходе этой лабораторной работы вы написали веб-приложение и настроили Cloud Run для автоматического развертывания вашего приложения при внесении изменений в исходный код вашего приложения. Затем вы изменили свое приложение и снова развернули его.
Если вам понравилась эта лабораторная работа, вы можете попробовать ее еще раз на другом языке программирования или в другой среде:
Вот несколько вариантов продолжения обучения:
- Документация Genkit: начало работы
- Codelab для добавления наблюдаемости в ваше приложение Node.js: практические методы наблюдения для приложения генеративного ИИ на Javascript
- Codelab для добавления внешнего интерфейса в ваше приложение с помощью Next.js: автоматическое развертывание веб-приложения Generative AI Next.js из системы управления версиями в облако
- Codelab, чтобы показать, как использовать вызов функций: Как использовать вызов функций Gemini с Cloud Run
- Codelab для использования искусственного интеллекта для обработки видеоконтента: как использовать Cloud Run Jobs Video Intelligence API для пошаговой обработки видео