Java ile InnerLoop Geliştirme - SpringBoot

1. Genel Bakış

Bu laboratuvarda, container mimarisine alınmış bir ortamda Java uygulamaları geliştirmekle görevli yazılım mühendislerinin geliştirme iş akışını kolaylaştırmak için tasarlanmış özellikler ve işlevler gösterilmektedir. Tipik container geliştirme sürecinde kullanıcının container'larla ve container derleme işlemiyle ilgili ayrıntıları anlaması gerekir. Ayrıca geliştiriciler, uygulamalarını uzak ortamlarda test edip hata ayıklama yapmak için genellikle akışlarını kesip IDE'lerinden çıkmak zorunda kalırlar. Bu eğitimde bahsedilen araçlar ve teknolojiler sayesinde geliştiriciler, IDE'lerinden ayrılmadan kapsayıcılı uygulamalarla etkili bir şekilde çalışabilir.

Öğrenecekleriniz

Bu laboratuvarda, GCP'de kapsayıcılarla geliştirme yöntemlerini öğreneceksiniz. Bu yöntemler arasında şunlar yer alır:

• Kurulum ve Gereksinimler
• Yeni bir Java başlangıç uygulaması oluşturma
• Geliştirme sürecini inceleme
• Basit bir CRUD Rest hizmeti geliştirme
• Temizleme

2. Kurulum ve Gereksinimler

Yönlendirmesiz ortam kurulumu

1. Google Cloud Console'da oturum açın ve yeni bir proje oluşturun veya mevcut bir projeyi yeniden kullanın. Gmail veya Google Workspace hesabınız yoksa hesap oluşturmanız gerekir.

• Proje adı, bu projenin katılımcıları için görünen addır. Google API'leri tarafından kullanılmayan bir karakter dizisidir ve istediğiniz zaman güncelleyebilirsiniz.
• Proje kimliği, tüm Google Cloud projelerinde benzersiz olmalı ve sabittir (ayarlandıktan sonra değiştirilemez). Cloud Console, benzersiz bir dizeyi otomatik olarak oluşturur. Genellikle bu dizenin ne olduğuyla ilgilenmezsiniz. Çoğu codelab'de proje kimliğine (genellikle PROJECT_ID olarak tanımlanır) başvurmanız gerekir. Bu nedenle, proje kimliğini beğenmezseniz başka bir rastgele kimlik oluşturabilir veya kendi kimliğinizi deneyip kullanılabilir olup olmadığını görebilirsiniz. Proje oluşturulduktan sonra bu değer "dondurulur".
• Bazı API'lerin kullandığı üçüncü bir değer olan Proje Numarası da vardır. Bu üç değer hakkında daha fazla bilgiyi belgelerde bulabilirsiniz.

Dikkat: Proje kimliği genel olarak benzersiz olmalı ve seçildikten sonra başka bir kullanıcı tarafından kullanılamamalıdır. Bu kimliğin tek kullanıcısı sizsiniz. Silinen projelerin kimlikleri bir daha kullanılamaz.

Not: Gmail hesabı kullanıyorsanız varsayılan konumu Kuruluş yok olarak bırakabilirsiniz. Google Workspace hesabı kullanıyorsanız kuruluşunuz için uygun bir konum seçin.

2. Ardından, Cloud kaynaklarını/API'lerini kullanmak için Cloud Console'da faturalandırmayı etkinleştirmeniz gerekir. Bu codelab'i tamamlamak neredeyse hiç maliyetli değildir. Bu eğitimin ötesinde faturalandırma ücreti alınmaması için kaynakları kapatmak üzere codelab'in sonunda bulunan "temizleme" talimatlarını uygulayın. Google Cloud'un yeni kullanıcıları 300 ABD doları değerinde ücretsiz deneme programından yararlanabilir.

Cloud Shell Düzenleyici'yi başlatma

Bu laboratuvar, Google Cloud Shell Düzenleyici ile kullanılmak üzere tasarlanmış ve test edilmiştir. Düzenleyiciye erişmek için:

1. https://console.cloud.google.com adresinden Google projenize erişin.
2. Sağ üst köşedeki Cloud Shell düzenleyici simgesini tıklayın.

3. Pencerenizin alt kısmında yeni bir bölme açılır.
4. Open Editor (Düzenleyiciyi Aç) düğmesini tıklayın.

5. Düzenleyici, sağda bir gezgin ve merkezi alanda bir düzenleyiciyle açılır.
6. Ekranın alt kısmında bir terminal bölmesi de bulunmalıdır.
7. Terminal açık DEĞİLSE yeni bir terminal penceresi açmak için `ctrl+`` tuş kombinasyonunu kullanın.

gcloud'u ayarlama

Cloud Shell'de proje kimliğinizi ve uygulamanızı dağıtmak istediğiniz bölgeyi ayarlayın. Bunları PROJECT_ID ve REGION değişkenleri olarak kaydedin.

export PROJECT_ID=$(gcloud config get-value project)
export PROJECT_NUMBER=$(gcloud projects describe $PROJECT_ID --format='value(projectNumber)')

Kaynak kodu alma

Bu laboratuvarın kaynak kodu, GitHub'daki GoogleCloudPlatform'da bulunan container-developer-workshop'ta yer alır. Aşağıdaki komutla klonlayın ve dizine gidin.

git clone https://github.com/GoogleCloudPlatform/container-developer-workshop.git
cd container-developer-workshop/labs/spring-boot

Bu laboratuvarda kullanılan altyapıyı sağlama

Bu laboratuvarda, GKE'ye kod dağıtacak ve Cloud SQL veritabanında depolanan verilere erişeceksiniz. Aşağıdaki kurulum komut dosyası bu altyapıyı sizin için hazırlar. Hazırlama işlemi 10 dakikadan uzun sürer. Kurulum işlemi devam ederken sonraki adımlara geçebilirsiniz.

./setup.sh

3. Yeni bir Java başlangıç uygulaması oluşturma

Bu bölümde, spring.io tarafından sağlanan örnek bir uygulamayı kullanarak sıfırdan yeni bir Java Spring Boot uygulaması oluşturacaksınız.

Örnek uygulamayı klonlama

1. Başlangıç uygulaması oluşturma

curl  https://start.spring.io/starter.zip -d dependencies=web -d type=maven-project -d javaVersion=11 -d packageName=com.example.springboot -o sample-app.zip

2. Uygulamanın sıkıştırmasını açın

unzip sample-app.zip -d sample-app

3. sample-app dizinine geçin ve klasörü Cloud Shell IDE çalışma alanında açın.

cd sample-app && cloudshell workspace .

spring-boot-devtools ve Jib'i ekleyin

Spring Boot Geliştirici Araçları'nı etkinleştirmek için düzenleyicinizdeki gezginden pom.xml dosyasını bulup açın. Ardından, <description>Demo project for Spring Boot</description> yazan açıklama satırının sonrasına aşağıdaki kodu yapıştırın.

1. pom.xml dosyasına spring-boot-devtools ekleyin

Projenin kök dizininde pom.xml dosyasını açın. Description girişinden sonra aşağıdaki yapılandırmayı ekleyin.

pom.xml

  <!--  Spring profiles-->
  <profiles>
    <profile>
      <id>sync</id>
      <dependencies>
        <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-devtools</artifactId>
        </dependency>
      </dependencies>
    </profile>
  </profiles>

2. pom.xml dosyasında jib-maven-plugin'i etkinleştirin.

Jib, Google'ın açık kaynaklı bir Java container oluşturma aracıdır. Java geliştiricilerin, bildikleri Java araçlarını kullanarak container oluşturmasına olanak tanır. Jib, uygulamanızı container görüntüsüne paketleme adımlarının tümünü yöneten hızlı ve basit bir container görüntüsü oluşturucudur. Dockerfile yazmanızı veya Docker'ın yüklü olmasını gerektirmez ve doğrudan Maven ve Gradle'e entegre edilmiştir.

pom.xml dosyasında aşağı kaydırın ve Build bölümünü Jib eklentisini içerecek şekilde güncelleyin. Tamamlandığında derleme bölümü aşağıdaki gibi olmalıdır.

pom.xml

  <build>
    <plugins>
      <plugin>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-maven-plugin</artifactId>
      </plugin>
      <!--  Jib Plugin-->
      <plugin>
        <groupId>com.google.cloud.tools</groupId>
        <artifactId>jib-maven-plugin</artifactId>
        <version>3.2.0</version>
      </plugin>
       <!--  Maven Resources Plugin-->
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-resources-plugin</artifactId>
        <version>3.1.0</version>
      </plugin>
    </plugins>
  </build>

Derleme dosyası değişikliği hakkında sorulursa Always seçeneğini belirleyin.

Manifest Dosyaları Oluşturma

Skaffold, container geliştirmeyi basitleştirmek için entegre araçlar sunar. Bu adımda, temel Kubernetes YAML dosyalarını otomatik olarak oluşturacak olan skaffold'u başlatacaksınız. Bu işlem, Dockerfile gibi container görüntüsü tanımlarının bulunduğu dizinleri tanımlamaya çalışır ve ardından her biri için bir dağıtım ve hizmet manifestosu oluşturur.

İşlemi başlatmak için aşağıdaki komutu yürütün.

1. Terminalde aşağıdaki komutu çalıştırın.

skaffold init --generate-manifests

2. İstendiğinde:

• İmlecinizi Jib Maven Plugin simgesine taşımak için okları kullanın.
• Seçeneği belirlemek için boşluk tuşuna basın.
• Devam etmek için Enter tuşuna basın

3. Bağlantı noktası olarak 8080 girin.
4. Yapılandırmayı kaydetmek için y girin.

Çalışma alanına skaffold.yaml ve deployment.yaml olmak üzere iki dosya eklenir.

Uygulama adını güncelleme

Yapılandırmaya dahil edilen varsayılan değerler şu anda uygulamanızın adıyla eşleşmiyor. Dosyaları, varsayılan değerler yerine uygulama adınıza referans verecek şekilde güncelleyin.

1. Skaffold yapılandırmasındaki girişleri değiştirme

• skaffold.yaml uygulamasını aç
• Şu anda pom-xml-image olarak ayarlanmış resim adını seçin.
• Sağ tıklayın ve Tüm Oluşumları Değiştir'i seçin.
• Yeni adı demo-app olarak yazın.

2. Kubernetes yapılandırmasındaki girişleri değiştirme

• deployment.yaml dosyasını aç
• Şu anda pom-xml-image olarak ayarlanmış resim adını seçin.
• Sağ tıklayın ve Tüm Oluşumları Değiştir'i seçin.
• Yeni adı demo-app olarak yazın.

Hızlı senkronizasyonu etkinleştirme

Optimize edilmiş bir sıcak yeniden yükleme deneyimi sağlamak için Jib tarafından sunulan Senkronizasyon özelliğini kullanacaksınız. Bu adımda, derleme işlemi sırasında bu özellikten yararlanmak için Skaffold'u yapılandıracaksınız.

Skaffold yapılandırmasında yapılandırdığınız "senkronizasyon" profilinin, önceki adımda yapılandırdığınız Spring "senkronizasyon" profilinden yararlandığını unutmayın. Bu adımda spring-dev-tools desteğini etkinleştirmiştiniz.

1. Skaffold yapılandırmasını güncelleme

skaffold.yaml dosyasında, dosyanın tamamını aşağıdaki spesifikasyonla değiştirin. Dosyanın diğer bölümlerini değiştirmeyin.

skaffold.yaml

build:
  artifacts:
  - image: demo-app
    jib:
      project: com.example:demo
      type: maven
      args: 
      - --no-transfer-progress
      - -Psync
      fromImage: gcr.io/distroless/java:debug
    sync:
      auto: true

Varsayılan rota ekleme

/src/main/java/com/example/springboot/ konumunda HelloController.java adlı bir dosya oluşturun.

Varsayılan bir http rotası oluşturmak için aşağıdaki içerikleri dosyaya yapıştırın.

HelloController.java

package com.example.springboot;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.beans.factory.annotation.Value;

@RestController
public class HelloController {

    @Value("${target:local}")
    String target;

    @GetMapping("/") 
    public String hello()
    {
        return String.format("Hello from your %s environment!", target);
    }
}

4. Geliştirme sürecini inceleme

Bu bölümde, temel süreçleri öğrenmek ve başlangıç uygulamanızın yapılandırmasını ve kurulumunu doğrulamak için Cloud Code eklentisini kullanarak birkaç adımı inceleyeceksiniz.

Cloud Code, geliştirme sürecinizi kolaylaştırmak için skaffold ile entegre olur. Aşağıdaki adımlarda GKE'ye dağıtım yaptığınızda Cloud Code ve Skaffold, container görüntünüzü otomatik olarak oluşturur, Container Registry'ye aktarır ve ardından uygulamanızı GKE'ye dağıtır. Bu işlem, geliştirici akışından ayrıntıları soyutlayarak arka planda gerçekleşir. Cloud Code, kapsayıcı tabanlı geliştirmeye geleneksel hata ayıklama ve anında senkronizasyon özellikleri sunarak geliştirme sürecinizi de iyileştirir.

Kubernetes'e dağıtma

1. Cloud Shell Düzenleyici'nin alt kısmındaki bölmede Cloud Code'u seçin. 

2. En üstte görünen panelde Kubernetes'te hata ayıklama'yı seçin. İstenirse mevcut Kubernetes bağlamını kullanmak için Evet'i seçin.

3. Komutu ilk kez çalıştırdığınızda ekranın üst kısmında, mevcut Kubernetes bağlamını kullanmak isteyip istemediğinizi soran bir istem görünür. Mevcut bağlamı kabul etmek ve kullanmak için "Evet"i seçin.

4. Ardından, hangi Container Registry'nin kullanılacağını soran bir istem gösterilir. Sağlanan varsayılan değeri kabul etmek için Enter tuşuna basın.

5. İlerleme durumunu ve bildirimleri görüntülemek için alt bölmede Çıkış sekmesini seçin.

6. Ek ayrıntıları ve kapsayıcılardan canlı olarak yayınlanan günlükleri görüntülemek için sağdaki kanal açılır listesinde "Kubernetes: Run/Debug - Detailed"ı seçin.

7. Açılır listeden "Kubernetes: Run/Debug" (Kubernetes: Çalıştır/Hata Ayıkla) seçeneğini belirleyerek basitleştirilmiş görünüme dönün.
8. Derleme ve testler tamamlandığında Çıkış sekmesinde Resource deployment/demo-app status completed successfully ifadesi gösterilir ve "Forwarded URL from service demo-app: http://localhost:8080" URL'si listelenir.
9. Cloud Code terminalinde, çıkıştaki URL'nin (http://localhost:8080) üzerine gelin ve ardından görüntülenen araç ipucunda Open Web Preview'u (Web Önizlemesini Aç) seçin.

Yanıt şöyle olur:

Hello from your local environment!

Kesme noktalarından yararlanma

1. /src/main/java/com/example/springboot/HelloController.java konumundaki HelloController.java uygulamasını açın.
2. Kök yol için return String.format("Hello from your %s environment!", target); ifadesini içeren dönüş ifadesini bulun.
3. Satır numarasının solundaki boş alanı tıklayarak bu satıra kesme noktası ekleyin. Kesme noktasının ayarlandığını belirtmek için kırmızı bir gösterge gösterilir.
4. Tarayıcınızı yeniden yükleyin. Hata ayıklayıcının işlemi kesme noktasında durdurduğunu ve GKE'de uzaktan çalışan uygulamanın değişkenlerini ve durumunu incelemenize olanak tanıdığını unutmayın.
5. "Hedef" değişkenini bulana kadar değişkenler bölümünü tıklayın.
6. Mevcut değeri "local" olarak gözlemleyin.
7. "target" değişken adını çift tıklayın ve pop-up'ta değeri "Cloud" gibi farklı bir değerle değiştirin.
8. Hata ayıklama kontrol panelinde Devam düğmesini tıklayın.
9. Tarayıcınızda, az önce girdiğiniz güncellenmiş değeri gösteren yanıtı inceleyin.

Hot Reload

1. İfadeyi "Merhaba %s Kod" gibi farklı bir değer döndürecek şekilde değiştirin.
2. Dosya otomatik olarak kaydedilir ve GKE'deki uzak kapsayıcılara senkronize edilir.
3. Güncellenen sonuçları görmek için tarayıcınızı yenileyin.
4. Hata ayıklama araç çubuğundaki kırmızı kareyi tıklayarak hata ayıklama oturumunu durdurun.

5. Basit bir CRUD Rest hizmeti geliştirme

Bu noktada uygulamanız, container'lı geliştirme için tamamen yapılandırılmış ve Cloud Code ile temel geliştirme iş akışını tamamlamış olursunuz. Aşağıdaki bölümlerde, Google Cloud'da yönetilen bir veritabanına bağlanan REST hizmeti uç noktaları ekleyerek öğrendiklerinizi uygulayacaksınız.

Bağımlılıkları Yapılandırma

Uygulama kodu, geri kalan hizmet verilerini kalıcı hale getirmek için bir veritabanı kullanır. pom.xl dosyasına aşağıdakileri ekleyerek bağımlılıkların kullanılabilir olduğundan emin olun.

1. pom.xml dosyasını açın ve yapılandırmanın bağımlılıklar bölümüne aşağıdakileri ekleyin.

pom.xml

    <!--  Database dependencies-->
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <dependency>
      <groupId>com.h2database</groupId>
      <artifactId>h2</artifactId>
      <scope>runtime</scope>
    </dependency>
    <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <scope>runtime</scope>
    </dependency>
    <dependency>
      <groupId>org.flywaydb</groupId>
      <artifactId>flyway-core</artifactId>
    </dependency>

Geri kalan hizmeti kodlama

Quote.java

/src/main/java/com/example/springboot/ dizininde Quote.java adlı bir dosya oluşturun ve aşağıdaki kodu kopyalayın. Bu, uygulamada kullanılan Fiyat Teklifi nesnesinin Varlık modelini tanımlar.

package com.example.springboot;

import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.Table;
import java.util.Objects;

@Entity
@Table(name = "quotes")
public class Quote
{
    @Id
    @Column(name = "id")
    private Integer id;

    @Column(name="quote")
    private String quote;

    @Column(name="author")
    private String author;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getQuote() {
        return quote;
    }

    public void setQuote(String quote) {
        this.quote = quote;
    }

    public String getAuthor() {
        return author;
    }

    public void setAuthor(String author) {
        this.author = author;
    }

    @Override
    public boolean equals(Object o) {
      if (this == o) {
        return true;
      }
      if (o == null || getClass() != o.getClass()) {
        return false;
      }
        Quote quote1 = (Quote) o;
        return Objects.equals(id, quote1.id) &&
                Objects.equals(quote, quote1.quote) &&
                Objects.equals(author, quote1.author);
    }

    @Override
    public int hashCode() {
        return Objects.hash(id, quote, author);
    }
}

QuoteRepository.java

src/main/java/com/example/springboot konumunda QuoteRepository.java adlı bir dosya oluşturun ve aşağıdaki kodu kopyalayın.

package com.example.springboot;

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;

public interface QuoteRepository extends JpaRepository<Quote,Integer> {

    @Query( nativeQuery = true, value =
            "SELECT id,quote,author FROM quotes ORDER BY RANDOM() LIMIT 1")
    Quote findRandomQuote();
}

Bu kod, verileri kalıcı hale getirmek için JPA'yı kullanır. Bu sınıf, Spring JPARepository arayüzünü genişletir ve özel kod oluşturulmasına olanak tanır. Eklediğiniz koda findRandomQuote özel bir yöntem ekleyin.

QuoteController.java

Hizmetin uç noktasını kullanıma sunmak için QuoteController sınıfı bu işlevi sağlar.

src/main/java/com/example/springboot konumunda QuoteController.java adlı bir dosya oluşturun ve aşağıdaki içerikleri kopyalayın.

package com.example.springboot;

import java.util.ArrayList;
import java.util.List;
import java.util.Optional;

import org.springframework.dao.EmptyResultDataAccessException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class QuoteController {

    private final QuoteRepository quoteRepository;

    public QuoteController(QuoteRepository quoteRepository) {
        this.quoteRepository = quoteRepository;
    }

    @GetMapping("/random-quote") 
    public Quote randomQuote()
    {
        return quoteRepository.findRandomQuote();  
    }

    @GetMapping("/quotes") 
    public ResponseEntity<List<Quote>> allQuotes()
    {
        try {
            List<Quote> quotes = new ArrayList<Quote>();
            
            quoteRepository.findAll().forEach(quotes::add);

            if (quotes.size()==0 || quotes.isEmpty()) 
                return new ResponseEntity<List<Quote>>(HttpStatus.NO_CONTENT);
                
            return new ResponseEntity<List<Quote>>(quotes, HttpStatus.OK);
        } catch (Exception e) {
            System.out.println(e.getMessage());
            return new ResponseEntity<List<Quote>>(HttpStatus.INTERNAL_SERVER_ERROR);
        }        
    }

    @PostMapping("/quotes")
    public ResponseEntity<Quote> createQuote(@RequestBody Quote quote) {
        try {
            Quote saved = quoteRepository.save(quote);
            return new ResponseEntity<Quote>(saved, HttpStatus.CREATED);
        } catch (Exception e) {
            System.out.println(e.getMessage());
            return new ResponseEntity<Quote>(HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }     

    @PutMapping("/quotes/{id}")
    public ResponseEntity<Quote> updateQuote(@PathVariable("id") Integer id, @RequestBody Quote quote) {
        try {
            Optional<Quote> existingQuote = quoteRepository.findById(id);
            
            if(existingQuote.isPresent()){
                Quote updatedQuote = existingQuote.get();
                updatedQuote.setAuthor(quote.getAuthor());
                updatedQuote.setQuote(quote.getQuote());

                return new ResponseEntity<Quote>(updatedQuote, HttpStatus.OK);
            } else {
                return new ResponseEntity<Quote>(HttpStatus.NOT_FOUND);
            }
        } catch (Exception e) {
            System.out.println(e.getMessage());
            return new ResponseEntity<Quote>(HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }     

    @DeleteMapping("/quotes/{id}")
    public ResponseEntity<HttpStatus> deleteQuote(@PathVariable("id") Integer id) {
        try {
            quoteRepository.deleteById(id);
            return new ResponseEntity<>(HttpStatus.NO_CONTENT);
        } catch (RuntimeException e) {
            System.out.println(e.getMessage());
            return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }    
}

Veritabanı Yapılandırmaları Ekleme

application.yaml

Hizmetin eriştiği arka uç veritabanı için yapılandırma ekleyin. application.yaml adlı dosyayı src/main/resources altında düzenleyin (yoksa oluşturun) ve arka uç için parametrelendirilmiş bir Spring yapılandırması ekleyin.

target: local

spring:
  config:
    activate:
      on-profile: cloud-dev
  datasource:
    url: 'jdbc:postgresql://${DB_HOST:127.0.0.1}/${DB_NAME:quote_db}'
    username: '${DB_USER:user}'
    password: '${DB_PASS:password}'
  jpa:
    properties:
      hibernate:
        jdbc:
          lob:
            non_contextual_creation: true
        dialect: org.hibernate.dialect.PostgreSQLDialect
    hibernate:
      ddl-auto: update

Veritabanı Taşıma Ekleme

src/main/resources/db/migration/ konumunda bir klasör oluşturun.

SQL dosyası oluşturun: V1__create_quotes_table.sql

Aşağıdaki içeriği dosyaya yapıştırın.

V1__create_quotes_table.sql

CREATE TABLE quotes(
   id INTEGER PRIMARY KEY,
   quote VARCHAR(1024),
   author VARCHAR(256)
);

INSERT INTO quotes (id,quote,author) VALUES (1,'Never, never, never give up','Winston Churchill');
INSERT INTO quotes (id,quote,author) VALUES (2,'While there''s life, there''s hope','Marcus Tullius Cicero');
INSERT INTO quotes (id,quote,author) VALUES (3,'Failure is success in progress','Anonymous');
INSERT INTO quotes (id,quote,author) VALUES (4,'Success demands singleness of purpose','Vincent Lombardi');
INSERT INTO quotes (id,quote,author) VALUES (5,'The shortest answer is doing','Lord Herbert');

Kubernetes Yapılandırması

deployment.yaml dosyasına yapılan aşağıdaki eklemeler, uygulamanın Cloud SQL örneklerine bağlanmasına olanak tanır.

• TARGET: Değişkeni, uygulamanın yürütüldüğü ortamı belirtecek şekilde yapılandırır.
• SPRING_PROFILES_ACTIVE: cloud-dev olarak yapılandırılacak etkin Spring profilini gösterir.
• DB_HOST: Veritabanı örneği oluşturulurken not edilen veya Google Cloud Console'un gezinme menüsünde SQL simgesi tıklanarak elde edilen veritabanının özel IP'si. Lütfen değeri değiştirin.
• DB_USER ve DB_PASS: Cloud SQL örneği yapılandırmasında ayarlandığı gibi, GCP'de Secret olarak depolanır.

deployment.yaml dosyanızı aşağıdaki içeriklerle güncelleyin.

deployment.yaml

apiVersion: v1
kind: Service
metadata:
  name: demo-app
  labels:
    app: demo-app
spec:
  ports:
  - port: 8080
    protocol: TCP
  clusterIP: None
  selector:
    app: demo-app
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: demo-app
  labels:
    app: demo-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: demo-app
  template:
    metadata:
      labels:
        app: demo-app
    spec:
      containers:
      - name: demo-app
        image: demo-app
        env:
          - name: PORT
            value: "8080"
          - name: TARGET
            value: "Local Dev - CloudSQL Database - K8s Cluster"
          - name: SPRING_PROFILES_ACTIVE
            value: cloud-dev
          - name: DB_HOST
            value: ${DB_INSTANCE_IP}   
          - name: DB_PORT
            value: "5432"  
          - name: DB_USER
            valueFrom:
              secretKeyRef:
                name: gke-cloud-sql-secrets
                key: username
          - name: DB_PASS
            valueFrom:
              secretKeyRef:
                name: gke-cloud-sql-secrets
                key: password
          - name: DB_NAME
            valueFrom:
              secretKeyRef:
                name: gke-cloud-sql-secrets
                key: database 

DB_HOST değerini veritabanınızın adresiyle değiştirin.

export DB_INSTANCE_IP=$(gcloud sql instances describe quote-db-instance \
    --format=json | jq \
    --raw-output ".ipAddresses[].ipAddress")

envsubst < deployment.yaml > deployment.new && mv deployment.new deployment.yaml

Uygulamayı Dağıtma ve Doğrulama

1. Cloud Shell Düzenleyici'nin alt kısmındaki bölmede Cloud Code'u, ardından ekranın üst kısmında Kubernetes'te hata ayıklama'yı seçin.
2. Derleme ve testler tamamlandığında Çıkış sekmesinde Resource deployment/demo-app status completed successfully ifadesi gösterilir ve "Forwarded URL from service demo-app: http://localhost:8080" URL'si listelenir.
3. Rastgele Alıntıları Görüntüleme

Cloud Shell terminalinden, aşağıdaki komutu random-quote uç noktasına karşı birden çok kez çalıştırın. Tekrarlanan aramaların farklı alıntılar döndürdüğünü gözlemleme

curl -v 127.0.0.1:8080/random-quote

4. Alıntı ekleme

Aşağıda listelenen komutu kullanarak id=6 ile yeni bir fiyat teklifi oluşturun ve isteğin tekrar gönderildiğini gözlemleyin.

curl -v -H 'Content-Type: application/json' -d '{"id":"6","author":"Henry David Thoreau","quote":"Go confidently in the direction of your dreams! Live the life you have imagined"}' -X POST 127.0.0.1:8080/quotes

5. Alıntı silme

Şimdi, az önce eklediğiniz alıntıyı silme yöntemiyle silin ve HTTP/1.1 204 yanıt kodunu gözlemleyin.

curl -v -X DELETE 127.0.0.1:8080/quotes/6

6. Sunucu Hatası

Giriş silindikten sonra son isteği tekrar çalıştırarak hata durumunu deneyimleme

curl -v -X DELETE 127.0.0.1:8080/quotes/6

Yanıtın HTTP:500 Internal Server Error döndürdüğünü fark edin.

Uygulamada hata ayıklama

Önceki bölümde, veritabanında olmayan bir girişi silmeye çalıştığınızda uygulamada bir hata durumuyla karşılaştınız. Bu bölümde, sorunu bulmak için bir kesme noktası ayarlayacaksınız. Hata, DELETE işleminde oluştuğu için QuoteController sınıfıyla çalışacaksınız.

1. src.main.java.com.example.springboot.QuoteController.java dosyasını açın.
2. deleteQuote() yöntemini bulma
3. Veritabanından öğe silme satırını bulun: quoteRepository.deleteById(id);
4. Satır numarasının solundaki boş alanı tıklayarak ilgili satırda bir kesme noktası ayarlayın.
5. Kesme noktasının ayarlandığını gösteren kırmızı bir gösterge görünür.
6. delete komutunu tekrar çalıştırın.

curl -v -X DELETE 127.0.0.1:8080/quotes/6

7. Sol sütundaki simgeyi tıklayarak hata ayıklama görünümüne geri dönün.
8. Hata ayıklama satırının QuoteController sınıfında durdurulduğunu gözlemleyin.
9. Hata ayıklayıcıda step over simgesini tıklayın ve bir istisna oluşturulduğunu gözlemleyin.
10. Çok genel bir RuntimeException was caught. ifadesinin, istemciye ideal olmayan bir Dahili Sunucu Hatası HTTP 500 döndürdüğünü gözlemleyin.

   Trying 127.0.0.1:8080...
* Connected to 127.0.0.1 (127.0.0.1) port 8080 (#0)
> DELETE /quotes/6 HTTP/1.1
> Host: 127.0.0.1:8080
> User-Agent: curl/7.74.0
> Accept: */*
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 500
< Content-Length: 0
< Date: 
<
* Connection #0 to host 127.0.0.1 left intact

Kodu güncelleme

Kod yanlış ve EmptyResultDataAccessException istisnasını yakalamak ve HTTP 404 bulunamadı durum kodunu geri göndermek için istisna bloğunun yeniden düzenlenmesi gerekiyor.

Hatayı düzeltin.

1. Hata ayıklama oturumu çalışmaya devam ederken hata ayıklama denetim panelinde "devam" düğmesine basarak isteği tamamlayın.
2. Ardından, aşağıdaki bloğu koda ekleyin:

       } catch (EmptyResultDataAccessException e){
            return new ResponseEntity<HttpStatus>(HttpStatus.NOT_FOUND);
        }

Yöntem aşağıdaki gibi görünmelidir:

    public ResponseEntity<HttpStatus> deleteQuote(@PathVariable("id") Integer id) {
        try {
            quoteRepository.deleteById(id);
            return new ResponseEntity<>(HttpStatus.NO_CONTENT);
        } catch(EmptyResultDataAccessException e){
            return new ResponseEntity<HttpStatus>(HttpStatus.NOT_FOUND);
        } catch (RuntimeException e) {
            System.out.println(e.getMessage());
            return new ResponseEntity<>(HttpStatus.INTERNAL_SERVER_ERROR);
        }
    }

3. Silme komutunu yeniden çalıştırma

curl -v -X DELETE 127.0.0.1:8080/quotes/6

4. Hata ayıklayıcıda adımları uygulayın ve EmptyResultDataAccessException yakalandığını, arayana HTTP 404 Bulunamadı yanıtının döndürüldüğünü gözlemleyin.

   Trying 127.0.0.1:8080...
* Connected to 127.0.0.1 (127.0.0.1) port 8080 (#0)
> DELETE /quotes/6 HTTP/1.1
> Host: 127.0.0.1:8080
> User-Agent: curl/7.74.0
> Accept: */*
>
* Mark bundle as not supporting multiuse
< HTTP/1.1 404
< Content-Length: 0
< Date: 
<
* Connection #0 to host 127.0.0.1 left intact

5. Hata ayıklama araç çubuğundaki kırmızı kareyi tıklayarak hata ayıklama oturumunu durdurun.

6. Temizleme

Tebrikler! Bu laboratuvarda sıfırdan yeni bir Java uygulaması oluşturdunuz ve bu uygulamayı kapsayıcılarla etkili bir şekilde çalışacak şekilde yapılandırdınız. Ardından, geleneksel uygulama yığınlarında bulunan geliştirici akışını izleyerek uygulamanızı uzak bir GKE kümesine dağıtıp hatalarını ayıklarsınız.

Laboratuvarı tamamladıktan sonra temizlik yapmak için:

1. Laboratuvarda kullanılan dosyaları silin.

cd ~ && rm -rf container-developer-workshop

2. İlgili tüm altyapıyı ve kaynakları kaldırmak için projeyi silin.