1. قبل از شروع
Cloud Shell یک ابزار خط فرمان مبتنی بر مرورگر است که به شما امکان دسترسی به منابع Google Cloud را می دهد. Cloud Shell مدیریت پروژه ها و منابع Cloud Console خود را بدون نیاز به نصب Cloud SDK و سایر ابزارها بر روی سیستم شما آسان می کند.
شما از Cloud Shell برای ساخت و راه اندازی یک برنامه Spring Boot بدون ترک مرورگر خود استفاده خواهید کرد. برای انجام این کار، از کد نمونه ساخت اپلیکیشن با Spring Boot استفاده خواهید کرد.
پیش نیازها
- آشنایی با زبان و ابزارهای برنامه نویسی جاوا
- آشنایی با ویرایشگرهای متن استاندارد لینوکس مانند Vim، Emacs و nano
کاری که خواهی کرد
- از Cloud Shell استفاده کنید.
- یک برنامه ساده Spring Boot در Cloud Shell ایجاد کنید.
- برنامه را با استفاده از ویرایشگر کد در Cloud Shell ویرایش کنید.
- برنامه را از Cloud Shell اجرا کنید.
آنچه شما نیاز دارید
- یک پروژه Google Cloud
- یک مرورگر، مانند Google Chrome
2. راه اندازی و الزامات
تنظیم محیط خود به خود
- اگر قبلاً یک حساب Google ندارید، باید یک حساب ایجاد کنید . وارد کنسول Cloud شوید و یک پروژه جدید ایجاد کنید.
شناسه پروژه را به خاطر بسپارید، یک نام منحصر به فرد در تمام پروژه های Google Cloud (نام موجود در تصویر قبلاً گرفته شده است و برای شما کار نخواهد کرد، متأسفیم!). بعداً در آزمایشگاه کد به عنوان PROJECT_ID نامیده خواهد شد.
- در مرحله بعد، برای استفاده از منابع Google Cloud باید صورتحساب را در کنسول Cloud فعال کنید . گذراندن از طریق Codelab نباید بیش از چند دلار برای شما هزینه داشته باشد، اما اگر تصمیم به استفاده از منابع بیشتری داشته باشید یا اگر آنها را در حال اجرا رها کنید ممکن است بیشتر باشد.
کاربران جدید Google Cloud واجد شرایط استفاده آزمایشی رایگان 300 دلاری هستند.
پوسته ابری
این ماشین مجازی مبتنی بر دبیان با تمام ابزارهای توسعه که شما نیاز دارید بارگذاری شده است. این دایرکتوری اصلی 5 گیگابایتی دائمی را ارائه می دهد و در Google Cloud اجرا می شود و عملکرد شبکه و احراز هویت را بسیار افزایش می دهد. این بدان معنی است که تمام چیزی که برای این کد لبه نیاز دارید یک مرورگر است (بله، روی کروم بوک کار می کند).
- برای فعال کردن Cloud Shell از Cloud Console، کافی است روی 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
شما می توانید مناطق مختلفی را انتخاب کنید. برای اطلاعات بیشتر، به مناطق و مناطق مراجعه کنید.
3. یک برنامه 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، همراه با Maven's pom.xml ، یک پوشش Maven و یک نقطه ورودی برنامه ایجاد می کند.
4. یک سرویس RESTful جدید با ویرایشگر کد ایجاد کنید
- ویرایشگر کد را با کلیک روی Open editor باز کنید
در منوی 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!";
}
}
- فایل را ذخیره کنید!
5. برنامه را به صورت محلی اجرا کنید
- با انتخاب
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
- پس از شروع برنامه، روی Web Preview کلیک کنید
در نوار ابزار Cloud Shell، سپس روی Preview در پورت 8080 کلیک کنید.
یک برگه در مرورگر شما باز می شود و به سروری که راه اندازی کرده اید متصل می شود.
6. تبریک می گویم
شما یاد گرفتید که یک برنامه وب جدید Spring Boot Java را مستقیماً از Cloud Shell بسازید و راه اندازی کنید.