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:
- Buka terminal.
Clone sumber untuk server konfigurasi:
git clone --depth 1 "https://github.com/google/kf"
Mengonfigurasi dan men-deploy server konfigurasi
Untuk memperbarui setelan instance:
Ubah direktori menjadi
spring-cloud-config-server
:cd kf/spring-cloud-config-server
Buka
manifest.yaml
.Ubah variabel lingkungan
GIT_URI
menjadi URI server konfigurasi Git Anda.Anda juga dapat mengubah nama aplikasi dalam manifes.
Secara opsional, konfigurasi properti tambahan atau sumber properti alternatif dengan mengedit
src/main/resources/application.properties
.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:
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
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 fileapplication.properties
atauapplication.yaml
. - Untuk framework lainnya, lihat informasi referensi library Anda.
Menghapus server konfigurasi
Untuk menghapus server konfigurasi:
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
Hapus entri layanan untuk server konfigurasi:
kf delete-service config-server
Hapus aplikasi server konfigurasi:
kf delete spring-cloud-config
Langkah selanjutnya
- Baca selengkapnya tentang jenis sumber konfigurasi yang didukung Spring Cloud Config.
- Pelajari struktur variabel lingkungan
VCAP_SERVICES
untuk memahami cara variabel tersebut dapat digunakan untuk penemuan layanan.