Men-deploy Spring Cloud Config

Dokumen ini menunjukkan cara men-deploy Spring Cloud Config di cluster Kf.

Spring Cloud Config menyediakan cara untuk memisahkan kode aplikasi dari konfigurasi runtime-nya. Server konfigurasi Spring Cloud Config dapat membaca file konfigurasi dari repositori Git, sistem file lokal, server Vault HashiCorp, atau Cloud Foundry CredHub. Setelah membaca konfigurasi, server konfigurasi dapat memformat dan menayangkan konfigurasi tersebut sebagai YAML, Java Properties, atau JSON melalui HTTP.

Sebelum memulai

Anda memerlukan cluster dengan Kf terinstal dan akses ke Kf CLI.

Selain itu, Anda akan memerlukan software berikut:

  • git: Git diperlukan untuk meng-clone repositori.

Mendownload server konfigurasi Spring Cloud Config

Untuk mendownload sumber server konfigurasi:

  1. Buka terminal.
  2. Clone sumber untuk server konfigurasi:

    git clone --depth 1 "https://github.com/google/kf"
    

Mengonfigurasi dan men-deploy server konfigurasi

Untuk memperbarui setelan instance:

  1. Ubah direktori menjadi spring-cloud-config-server:

    cd kf/spring-cloud-config-server
    
  2. Buka manifest.yaml.

  3. Ubah variabel lingkungan GIT_URI menjadi URI server konfigurasi Git Anda.

  4. Anda juga dapat mengubah nama aplikasi dalam manifes.

  5. Secara opsional, konfigurasi properti tambahan atau sumber properti alternatif dengan mengedit src/main/resources/application.properties.

  6. Deploy server konfigurasi tanpa rute eksternal. Jika Anda mengubah nama aplikasi dalam manifes, perbarui di sini:

    kf push --no-route spring-cloud-config
    

Mengikat aplikasi ke server konfigurasi

Anda dapat membuat layanan yang disediakan pengguna untuk mengikat server konfigurasi yang di-deploy ke aplikasi Kf lain di cluster atau namespace yang sama.

Cara mengonfigurasinya akan bergantung pada library yang Anda gunakan:

Aplikasi PCF

Aplikasi PCF yang ada dan menggunakan library klien Spring Cloud Services Pivotal dapat diikat menggunakan metode berikut:

  1. Buat layanan yang disediakan pengguna bernama config-server. Langkah ini hanya perlu dilakukan sekali per server konfigurasi:

    kf cups config-server -p '{"uri":"http://spring-cloud-config"}' -t configuration
    
  2. Untuk setiap aplikasi yang memerlukan kredensial, jalankan:

    kf bind-service application-name config-server
    kf restart application-name
    

    Tindakan ini akan membuat entri ke variabel lingkungan VCAP_SERVICES untuk server konfigurasi.

Aplikasi lainnya

Aplikasi yang dapat terhubung langsung ke server konfigurasi Spring Cloud Config harus dikonfigurasi untuk mengaksesnya menggunakan URI internal clusternya:

http://spring-cloud-config
  • Untuk aplikasi Spring yang menggunakan library klien Spring Cloud Config, Anda dapat menetapkan properti spring.cloud.config.uri di lokasi yang sesuai untuk aplikasi Anda. File ini biasanya berupa file application.properties atau application.yaml.
  • Untuk framework lainnya, lihat informasi referensi library Anda.

Menghapus server konfigurasi

Untuk menghapus server konfigurasi:

  1. Hapus semua binding ke server konfigurasi yang menjalankan perintah berikut untuk setiap aplikasi terikat:

    kf unbind-service application-name config-server
    kf restart application-name
    
  2. Hapus entri layanan untuk server konfigurasi:

    kf delete-service config-server
    
  3. Hapus aplikasi server konfigurasi:

    kf delete spring-cloud-config
    

Langkah selanjutnya