درباره این codelab
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>
Cloud Shell همچنین برخی از متغیرهای محیطی را به صورت پیش‌فرض تنظیم می‌کند که ممکن است هنگام اجرای دستورات آینده مفید باشند.
echo $GOOGLE_CLOUD_PROJECT
خروجی فرمان
<PROJECT_ID>
اگر به دلایلی پروژه تنظیم نشد، به سادگی دستور زیر را صادر کنید:
gcloud config set project <PROJECT_ID>
به دنبال PROJECT_ID خود هستید؟ بررسی کنید از چه شناسه ای در مراحل راه اندازی استفاده کرده اید یا آن را در داشبورد Cloud Console جستجو کنید.
- در نهایت، منطقه پیش فرض و پیکربندی پروژه را تنظیم کنید.
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 baseDir=helloworld | tar -xzvf -
این یک دایرکتوری جدید با یک پروژه جدید Maven، همراه با Maven's pom.xml ، یک پوشش Maven و یک نقطه ورودی برنامه ایجاد می کند.
4. یک سرویس RESTful جدید با ویرایشگر کد ایجاد کنید
- با کلیک روی Launch 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. برنامه را به صورت محلی اجرا کنید
- می توانید اپلیکیشن Spring Boot را به طور معمول با افزونه Spring Boot راه اندازی کنید.
$ cd $HOME/helloworld $ ./mvnw -DskipTests spring-boot:run
- پس از شروع برنامه، روی Web Preview کلیک کنید
در نوار ابزار Cloud Shell، سپس روی Preview در پورت 8080 کلیک کنید.
یک برگه در مرورگر شما باز می شود و به سروری که راه اندازی کرده اید متصل می شود.
6. تبریک می گویم
شما یاد گرفتید که یک برنامه وب جدید Spring Boot Java را مستقیماً از Cloud Shell بسازید و راه اندازی کنید.