1. بررسی اجمالی
استقرار یک برنامه وب برای اولین بار می تواند ترسناک باشد. حتی پس از اولین استقرار، اگر فرآیند کار زیاد باشد، ممکن است از استقرار نسخههای جدید برنامه خود اجتناب کنید. با استقرار مداوم، می توانید به راحتی تغییرات برنامه خود را به طور خودکار اجرا کنید.
در این آزمایشگاه، شما یک برنامه وب می نویسید و Cloud Run را پیکربندی می کنید تا زمانی که تغییری در کد منبع برنامه شما ایجاد می شود، برنامه شما به طور خودکار اجرا شود. سپس برنامه خود را تغییر داده و دوباره آن را مستقر می کنید.
آنچه خواهید آموخت
- با Cloud Shell Editor یک برنامه وب بنویسید
- کد برنامه خود را در GitHub ذخیره کنید
- به طور خودکار برنامه خود را در Cloud Run مستقر کنید
- با استفاده از Genkit هوش مصنوعی مولد را به برنامه خود اضافه کنید
- دستورات LLM را با استفاده از کتابخانه dotprompt مدیریت کنید
2. پیش نیازها
- اگر قبلاً یک حساب Google ندارید، باید یک حساب Google ایجاد کنید .
- از حساب شخصی به جای حساب کاری یا مدرسه استفاده کنید. حسابهای محل کار و مدرسه ممکن است محدودیتهایی داشته باشند که شما را از فعال کردن APIهای مورد نیاز برای این آزمایشگاه باز میدارد.
- اگر قبلاً یک حساب GitHub ندارید، باید یک حساب GitHub ایجاد کنید
- در صورت داشتن یک حساب کاربری GitHub موجود استفاده کنید. GitHub به احتمال زیاد یک حساب جدید را به عنوان هرزنامه مسدود می کند.
- احراز هویت دو مرحلهای را در حساب GitHub خود پیکربندی کنید تا احتمال علامتگذاری حسابتان بهعنوان هرزنامه را کاهش دهید.
3. راه اندازی پروژه
- به Google Cloud Console وارد شوید.
- صورتحساب را در کنسول Cloud فعال کنید .
- تکمیل این آزمایشگاه باید کمتر از 1 دلار آمریکا در منابع Cloud هزینه داشته باشد.
- برای جلوگیری از هزینه های بیشتر، می توانید مراحل انتهای این آزمایشگاه را برای حذف منابع دنبال کنید.
- کاربران جدید واجد شرایط استفاده از نسخه آزمایشی رایگان 300 دلاری هستند.
- در رویداد Gen AI for Devs شرکت می کنید؟ اعتبار 1 دلاری ممکن است در دسترس باشد.
- یک پروژه جدید ایجاد کنید یا استفاده مجدد از یک پروژه موجود را انتخاب کنید.
- تأیید اینکه صورتحساب در پروژههای من در صورتحساب ابری فعال است
- اگر پروژه جدید شما می گوید که صورتحساب در ستون
Billing account
Billing is disabled
:- روی سه نقطه در ستون
Actions
کلیک کنید - روی تغییر صورتحساب کلیک کنید
- حساب صورتحساب مورد نظر برای استفاده را انتخاب کنید
- روی سه نقطه در ستون
- اگر در یک رویداد Gen AI for Devs شرکت میکنید، احتمالاً نام حساب Google Cloud Trial Billing Account خواهد بود.
- اگر پروژه جدید شما می گوید که صورتحساب در ستون
4. Cloud Shell Editor را باز کنید
- به Cloud Shell Editor بروید
- اگر ترمینال در پایین صفحه ظاهر نشد، آن را باز کنید:
- روی منوی همبرگر کلیک کنید
- روی ترمینال کلیک کنید
- روی 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"
- شاخه پیشفرض global 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
- برای جلوگیری از ارتکاب
node_modules
فایل.gitignore
را اضافه کنیدecho node_modules/ >> .gitignore
- فایل
index.js
را در Cloud Shell Editor باز کنید: اکنون باید یک فایل خالی در قسمت بالای صفحه ظاهر شود. اینجا جایی است که می توانید این فایلcloudshell edit index.js
index.js
را ویرایش کنید. - کد زیر را کپی کرده و در فایل باز شده
index.js
قرار دهید: پس از چند ثانیه، Cloud Shell Editor کد شما را به صورت خودکار ذخیره می کند. این کد به درخواست های http با "سلام جهان!" ما پاسخ می دهد. احوالپرسی.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 CLI شوید
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 را باز کنید
- کد یکبار مصرف خود را جایگذاری کنید
- روی Authorize 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
- تمام فایل های موجود در فهرست فعلی را به این commit اضافه کنید:
git add .
- اولین commit را ایجاد کنید:
git commit -m "add http server"
- commit خود را به شاخه
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 Editor را باز بگذارید. بعداً به این برگه باز خواهیم گشت.
- در یک تب جدید، از صفحه Cloud Run دیدن کنید
- Google Cloud Project صحیح را در کنسول انتخاب کنید
- روی CONNECT REPO کلیک کنید
- روی SET UP WITH CLOUD BUILD کلیک کنید
- GitHub را به عنوان ارائه دهنده مخزن انتخاب کنید
- اگر به حساب GitHub خود در مرورگر وارد نشده اید، با اطلاعات کاربری خود وارد شوید.
- روی Authenticate و سپس Continue کلیک کنید.
- پس از ورود به سیستم، پیامی را در صفحه Cloud Run مشاهده خواهید کرد مبنی بر اینکه برنامه GitHub در هیچ یک از مخازن شما نصب نشده است.
- روی دکمه INSTALL GOOGLE CLOUD BUILD کلیک کنید.
- در صفحه راه اندازی نصب، فقط مخازن را انتخاب کنید و مخزن codelab-genai را که از طریق CLI ایجاد کرده اید انتخاب کنید.
- بر روی Install کلیک کنید
- توجه: اگر تعداد زیادی مخزن GitHub دارید، بارگیری آن ممکن است چند دقیقه طول بکشد.
-
your-user-name/codelab-genai
به عنوان مخزن انتخاب کنید- اگر مخزن موجود نیست، روی پیوند Manage Connected Repositories کلیک کنید.
- شعبه را به عنوان
^main$
ترک کنید - روی Go، Node.js، Python، Java، NET Core، Ruby یا PHP از طریق بستههای ساخت Google Cloud کلیک کنید.
- فیلدهای دیگر (
Build context directory
،Entrypoint
وFunction target
) را به همان شکلی که هستند رها کنید.
- فیلدهای دیگر (
- روی ذخیره کلیک کنید
- GitHub را به عنوان ارائه دهنده مخزن انتخاب کنید
- به سمت پایین اسکرول کنید تا به Authentication بروید
- روی اجازه دادن به فراخوانهای احراز هویت نشده کلیک کنید
- روی CREATE کلیک کنید
پس از اتمام ساخت (که چند دقیقه طول می کشد)، این دستور را اجرا کنید و برای مشاهده برنامه در حال اجرا خود، به 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 Editor برگردید
اگر هنوز Cloud Shell Editor را باز دارید، می توانید از این مراحل صرف نظر کنید.
- به Cloud Shell Editor بروید
- اگر ترمینال در پایین صفحه ظاهر نشد، آن را باز کنید:
- روی منوی همبرگر کلیک کنید
- روی ترمینال کلیک کنید
- روی 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
را اجرا کنید.
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
دوباره در ویرایشگر پوسته ابری باز کنید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 Editor باز کنید: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 Editor باز کنید: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 Editor باز کنید: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 Docs: شروع کنید
- Codelab برای افزودن قابلیت مشاهده به برنامه Node.js شما: تکنیکهای مشاهدهپذیری عملی برای برنامههای هوش مصنوعی تولیدی در جاوا اسکریپت
- Codelab برای افزودن فرانتاند به برنامهتان با Next.js: بهطور خودکار برنامه وب Next.js هوش مصنوعی مولد را از Version Control به Cloud Run اجرا کنید.
- Codelab برای نشان دادن نحوه استفاده از فراخوانی تابع: نحوه استفاده از فراخوانی تابع Gemini با Cloud Run
- Codelab برای استفاده از هوش مصنوعی برای پردازش محتوای ویدیویی: نحوه استفاده از Cloud Run Jobs Video Intelligence API برای پردازش صحنه به صحنه ویدیو
1. بررسی اجمالی
استقرار یک برنامه وب برای اولین بار می تواند ترسناک باشد. حتی پس از اولین استقرار، اگر فرآیند کار زیاد باشد، ممکن است از استقرار نسخههای جدید برنامه خود اجتناب کنید. با استقرار مداوم، می توانید به راحتی تغییرات برنامه خود را به طور خودکار اجرا کنید.
در این آزمایشگاه، شما یک برنامه وب می نویسید و Cloud Run را پیکربندی می کنید تا زمانی که تغییری در کد منبع برنامه شما ایجاد می شود، برنامه شما به طور خودکار اجرا شود. سپس برنامه خود را تغییر داده و دوباره آن را مستقر می کنید.
آنچه خواهید آموخت
- با Cloud Shell Editor یک برنامه وب بنویسید
- کد برنامه خود را در GitHub ذخیره کنید
- به طور خودکار برنامه خود را در Cloud Run مستقر کنید
- با استفاده از Genkit هوش مصنوعی مولد را به برنامه خود اضافه کنید
- دستورات LLM را با استفاده از کتابخانه dotprompt مدیریت کنید
2. پیش نیازها
- اگر قبلاً یک حساب Google ندارید، باید یک حساب Google ایجاد کنید .
- از حساب شخصی به جای حساب کاری یا مدرسه استفاده کنید. حسابهای محل کار و مدرسه ممکن است محدودیتهایی داشته باشند که شما را از فعال کردن APIهای مورد نیاز برای این آزمایشگاه باز میدارد.
- اگر قبلاً یک حساب GitHub ندارید، باید یک حساب GitHub ایجاد کنید
- در صورت داشتن یک حساب کاربری GitHub موجود استفاده کنید. GitHub به احتمال زیاد یک حساب جدید را به عنوان هرزنامه مسدود می کند.
- احراز هویت دو مرحلهای را در حساب GitHub خود پیکربندی کنید تا احتمال علامتگذاری حسابتان بهعنوان هرزنامه را کاهش دهید.
3. راه اندازی پروژه
- به Google Cloud Console وارد شوید.
- صورتحساب را در کنسول Cloud فعال کنید .
- تکمیل این آزمایشگاه باید کمتر از 1 دلار آمریکا در منابع Cloud هزینه داشته باشد.
- برای جلوگیری از هزینه های بیشتر، می توانید مراحل انتهای این آزمایشگاه را برای حذف منابع دنبال کنید.
- کاربران جدید واجد شرایط استفاده از نسخه آزمایشی رایگان 300 دلاری هستند.
- در رویداد Gen AI for Devs شرکت می کنید؟ اعتبار 1 دلاری ممکن است در دسترس باشد.
- یک پروژه جدید ایجاد کنید یا استفاده مجدد از یک پروژه موجود را انتخاب کنید.
- تأیید اینکه صورتحساب در پروژههای من در صورتحساب ابری فعال است
- اگر پروژه جدید شما می گوید که صورتحساب در ستون
Billing account
Billing is disabled
:- روی سه نقطه در ستون
Actions
کلیک کنید - روی تغییر صورتحساب کلیک کنید
- حساب صورتحساب مورد نظر برای استفاده را انتخاب کنید
- روی سه نقطه در ستون
- اگر در یک رویداد Gen AI for Devs شرکت میکنید، احتمالاً نام حساب Google Cloud Trial Billing Account خواهد بود.
- اگر پروژه جدید شما می گوید که صورتحساب در ستون
4. Cloud Shell Editor را باز کنید
- به Cloud Shell Editor بروید
- اگر ترمینال در پایین صفحه ظاهر نشد، آن را باز کنید:
- روی منوی همبرگر کلیک کنید
- روی ترمینال کلیک کنید
- روی 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"
- شاخه پیشفرض global 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
- برای جلوگیری از ارتکاب
node_modules
فایل.gitignore
را اضافه کنیدecho node_modules/ >> .gitignore
- فایل
index.js
را در Cloud Shell Editor باز کنید: اکنون باید یک فایل خالی در قسمت بالای صفحه ظاهر شود. اینجا جایی است که می توانید این فایلcloudshell edit index.js
index.js
را ویرایش کنید. - کد زیر را کپی کرده و در فایل باز شده
index.js
قرار دهید: پس از چند ثانیه، Cloud Shell Editor کد شما را به صورت خودکار ذخیره می کند. این کد به درخواست های http با "سلام جهان!" ما پاسخ می دهد. احوالپرسی.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 CLI شوید
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 را باز کنید
- کد یکبار مصرف خود را جایگذاری کنید
- روی Authorize 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
- تمام فایل های موجود در فهرست فعلی را به این commit اضافه کنید:
git add .
- اولین commit را ایجاد کنید:
git commit -m "add http server"
- commit خود را به شاخه
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 Editor را باز بگذارید. بعداً به این برگه باز خواهیم گشت.
- در یک تب جدید، از صفحه Cloud Run دیدن کنید
- Google Cloud Project صحیح را در کنسول انتخاب کنید
- روی CONNECT REPO کلیک کنید
- روی SET UP WITH CLOUD BUILD کلیک کنید
- GitHub را به عنوان ارائه دهنده مخزن انتخاب کنید
- اگر به حساب GitHub خود در مرورگر وارد نشده اید، با اطلاعات کاربری خود وارد شوید.
- روی Authenticate و سپس Continue کلیک کنید.
- پس از ورود به سیستم، پیامی را در صفحه Cloud Run مشاهده خواهید کرد مبنی بر اینکه برنامه GitHub در هیچ یک از مخازن شما نصب نشده است.
- روی دکمه INSTALL GOOGLE CLOUD BUILD کلیک کنید.
- در صفحه راه اندازی نصب، فقط مخازن را انتخاب کنید و مخزن codelab-genai را که از طریق CLI ایجاد کرده اید انتخاب کنید.
- بر روی Install کلیک کنید
- توجه: اگر تعداد زیادی مخزن GitHub دارید، بارگیری آن ممکن است چند دقیقه طول بکشد.
-
your-user-name/codelab-genai
به عنوان مخزن انتخاب کنید- اگر مخزن موجود نیست، روی پیوند Manage Connected Repositories کلیک کنید.
- شعبه را به عنوان
^main$
ترک کنید - روی Go، Node.js، Python، Java، NET Core، Ruby یا PHP از طریق بستههای ساخت Google Cloud کلیک کنید.
- فیلدهای دیگر (
Build context directory
،Entrypoint
وFunction target
) را به همان شکلی که هستند رها کنید.
- فیلدهای دیگر (
- روی ذخیره کلیک کنید
- GitHub را به عنوان ارائه دهنده مخزن انتخاب کنید
- به سمت پایین اسکرول کنید تا به Authentication بروید
- روی اجازه دادن به فراخوانهای احراز هویت نشده کلیک کنید
- روی CREATE کلیک کنید
پس از اتمام ساخت (که چند دقیقه طول می کشد)، این دستور را اجرا کنید و برای مشاهده برنامه در حال اجرا خود، به 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 Editor برگردید
اگر هنوز Cloud Shell Editor را باز دارید، می توانید از این مراحل صرف نظر کنید.
- به Cloud Shell Editor بروید
- اگر ترمینال در پایین صفحه ظاهر نشد، آن را باز کنید:
- روی منوی همبرگر کلیک کنید
- روی ترمینال کلیک کنید
- روی 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
را اجرا کنید.
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 Editor باز کنید: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 Editor باز کنید: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 Editor باز کنید: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 Docs: شروع کنید
- Codelab برای افزودن قابلیت مشاهده به برنامه Node.js شما: تکنیکهای مشاهدهپذیری عملی برای برنامههای هوش مصنوعی تولیدی در جاوا اسکریپت
- Codelab برای افزودن فرانتاند به برنامهتان با Next.js: بهطور خودکار برنامه وب Next.js هوش مصنوعی مولد را از Version Control به Cloud Run اجرا کنید.
- Codelab برای نشان دادن نحوه استفاده از فراخوانی تابع: نحوه استفاده از فراخوانی تابع Gemini با Cloud Run
- Codelab برای استفاده از هوش مصنوعی برای پردازش محتوای ویدیویی: نحوه استفاده از Cloud Run Jobs Video Intelligence API برای پردازش صحنه به صحنه ویدیو