Dokumen ini menunjukkan cara men-deploy Konfigurasi Spring Cloud 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 HashiCorp Vault, atau Cloud Foundry CredHub. Setelah server konfigurasi membaca konfigurasi, server tersebut dapat memformat dan menayangkan konfigurasi tersebut sebagai YAML, Java Properties, atau JSON melalui HTTP.
Sebelum memulai
Anda memerlukan cluster dengan Kf yang diinstal dan akses ke Kf CLI.
Selain itu, Anda 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
ke URI server konfigurasi Git Anda.Atau, ubah nama aplikasi dalam manifes.
Secara opsional, konfigurasi properti tambahan atau sumber properti alternatif dengan mengedit
src/main/resources/application.properties
.Men-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 yang 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 perlu mendapatkan 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 cluster-nya:
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. Nilai ini biasanya berupa fileapplication.properties
atauapplication.yaml
. - Untuk framework lain, 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 yang 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 menggunakannya untuk penemuan layanan.