۱. قبل از شروع
Cloud Shell یک ابزار خط فرمان مبتنی بر مرورگر است که به شما امکان دسترسی به منابع Google Cloud را میدهد. Cloud Shell مدیریت پروژهها و منابع Cloud Console شما را بدون نیاز به نصب Cloud SDK و سایر ابزارها روی سیستمتان آسان میکند.
شما از Cloud Shell برای ساخت و راهاندازی یک برنامه Spring Boot بدون نیاز به ترک مرورگر خود استفاده خواهید کرد. برای این کار، از کد نمونه موجود در «ساخت یک برنامه با Spring Boot» استفاده خواهید کرد.
پیشنیازها
- آشنایی با زبان برنامه نویسی جاوا و ابزارهای آن
- آشنایی با ویرایشگرهای متن استاندارد لینوکس مانند Vim، Emacs و nano
کاری که انجام خواهید داد
- از پوسته ابری استفاده کنید.
- یک برنامه ساده Spring Boot در Cloud Shell ایجاد کنید.
- برنامه را با استفاده از ویرایشگر کد در Cloud Shell ویرایش کنید.
- برنامه را از Cloud Shell اجرا کنید.
آنچه نیاز دارید
- یک پروژه ابری گوگل
- یک مرورگر، مثلاً گوگل کروم
۲. تنظیمات و الزامات
تنظیم محیط خودتنظیم
- اگر از قبل حساب گوگل ندارید، باید یکی ایجاد کنید . وارد Cloud Console شوید و یک پروژه جدید ایجاد کنید.


شناسه پروژه را به خاطر بسپارید، یک نام منحصر به فرد در تمام پروژههای Google Cloud (نام موجود در تصویر قبلاً گرفته شده و برای شما کار نخواهد کرد، متاسفیم!). بعداً در آزمایشگاه کد به آن با عنوان PROJECT_ID اشاره خواهد شد.
- در مرحله بعد، برای استفاده از منابع گوگل کلود، باید امکان پرداخت صورتحساب را در کنسول ابری فعال کنید. استفاده از codelab نباید بیش از چند دلار برای شما هزینه داشته باشد، اما اگر تصمیم به استفاده از منابع بیشتر بگیرید یا آنها را در حال اجرا رها کنید، میتواند بیشتر هم شود.
کاربران جدید گوگل کلود واجد شرایط دریافت یک دوره آزمایشی رایگان ۳۰۰ دلاری هستند.
پوسته ابری
این ماشین مجازی مبتنی بر دبیان، تمام ابزارهای توسعه مورد نیاز شما را در خود جای داده است. این ماشین مجازی یک دایرکتوری خانگی ۵ گیگابایتی دائمی ارائه میدهد و در فضای ابری گوگل اجرا میشود که عملکرد شبکه و احراز هویت را تا حد زیادی بهبود میبخشد. این بدان معناست که تنها چیزی که برای این آزمایشگاه کد نیاز دارید یک مرورگر است (بله، روی کرومبوک هم کار میکند).
- برای فعال کردن Cloud Shell از کنسول Cloud، کافیست روی Activate Cloud Shell کلیک کنید.
(فقط چند لحظه طول میکشد تا آماده شود و به محیط متصل شود).


پس از اتصال به Cloud Shell، باید ببینید که از قبل احراز هویت شدهاید و پروژه از قبل روی PROJECT_ID شما تنظیم شده است.
gcloud auth list
خروجی دستور
Credentialed accounts: - <myaccount>@<mydomain>.com (active)
gcloud config list project
خروجی دستور
[core] project = <PROJECT_ID>
اگر به هر دلیلی پروژه تنظیم نشده باشد، کافیست دستور زیر را اجرا کنید:
gcloud config set project <PROJECT_ID>
به دنبال PROJECT_ID خود هستید؟ بررسی کنید که در مراحل راهاندازی از چه شناسهای استفاده کردهاید یا آن را در داشبورد Cloud Console جستجو کنید:

Cloud Shell همچنین برخی از متغیرهای محیطی را به طور پیشفرض تنظیم میکند که ممکن است هنگام اجرای دستورات بعدی مفید باشند.
echo $GOOGLE_CLOUD_PROJECT
خروجی دستور
<PROJECT_ID>
- در نهایت، منطقه پیشفرض و پیکربندی پروژه را تنظیم کنید.
gcloud config set compute/zone us-central1-f
شما میتوانید مناطق مختلفی را انتخاب کنید. برای اطلاعات بیشتر، به بخش مناطق و نواحی مراجعه کنید.
۳. یک برنامه Spring Boot جدید را مقداردهی اولیه کنید
پس از نصب ابزار خط فرمان Spring Boot، میتوانید یک برنامه وب جدید "Hello, World" را مقداردهی اولیه و بوتاسترپ کنید.
$ curl https://start.spring.io/starter.tgz \ -d dependencies=web \ -d type=maven-project \ -d baseDir=helloworld | tar -xzvf -
این یک دایرکتوری جدید با یک پروژه جدید Maven، به همراه pom.xml مربوط به Maven، یک wrapper مربوط به Maven و یک نقطه ورود برنامه ایجاد میکند.
۴. با ویرایشگر کد، یک سرویس RESTful جدید ایجاد کنید
- با کلیک روی «باز کردن ویرایشگر»، ویرایشگر کد را باز کنید.
در منوی Cloud Shell. - پس از باز شدن ویرایشگر، فایل
helloworld/src/main/java/com/example/demo/DemoApplication.javaرا پیدا کنید.

- پس از باز شدن کد، یک کنترلر RESTful جدید برای پاسخ
Helloایجاد کنید. در فایلDemoApplication.java، علاوه بر تعریف فعلی، یک تعریف کلاسHelloworldجدید نیز اضافه کنید.
src/main/java/com/example/demo/DemoApplication.java
package com.example;
...
// Add the import
import org.springframework.web.bind.annotation.*;
@SpringBootApplication
public class DemoApplication {
...
}
// Add the controller
@RestController
class Helloworld {
@GetMapping("/")
public String greet() {
return "Hello!";
}
}
- فایل را ذخیره کنید!
۵. اجرای محلی برنامه
- با انتخاب
Terminalو سپسNew Terminalاز منوی ویرایشگر، یک ترمینال در ویرایشگر کد باز کنید. - مطمئن شوید که
JAVA_HOMEروی نسخه صحیح JDK تنظیم شده است:
$ export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/
- شما میتوانید برنامه Spring Boot را به طور معمول با افزونه Spring Boot اجرا کنید.
$ cd $HOME/helloworld $ ./mvnw -DskipTests spring-boot:run

- پس از شروع برنامه، روی پیشنمایش وب کلیک کنید
در نوار ابزار Cloud Shell، سپس روی پورت ۸۰۸۰ روی پیشنمایش کلیک کنید.

یک تب در مرورگر شما باز میشود و به سروری که راهاندازی کردهاید متصل میشود.

۶. تبریک
شما یاد گرفتید که یک برنامه وب Spring Boot Java جدید را مستقیماً از Cloud Shell بسازید و راهاندازی کنید.