Edge for Private Cloud v. 4.17.09
Untuk mengonfigurasi Edge setelah penginstalan, Anda dapat menggunakan kombinasi file .properties dan utilitas Edge. Sebagai misalnya, untuk mengonfigurasi TLS/SSL di UI Edge, Anda dapat mengedit file .properties untuk menyetel atribut properti baru. Perubahan pada file .properties mengharuskan Anda memulai ulang komponen Edge yang terpengaruh.
Apigee mengacu pada teknik pengeditan file .properties sebagai kode dengan konfigurasi. Pada dasarnya, kode dengan config adalah alat pencarian kunci/nilai berdasarkan pengaturan di file .properties. Dalam kode dengan konfigurasi, kunci disebut sebagai token. Oleh karena itu, untuk mengonfigurasi Edge, Anda perlu menetapkan token di file .properties.
Kode dengan konfigurasi memungkinkan komponen Edge untuk mengatur nilai default yang dikirimkan bersama memungkinkan tim instalasi mengganti pengaturan berdasarkan topologi instalasi, lalu memungkinkan pelanggan mengganti properti yang mereka pilih.
Jika Anda menganggapnya sebagai hierarki, maka pengaturannya akan diatur sebagai berikut dengan setelan yang memiliki prioritas tertinggi untuk menggantikan setelan apa pun dari tim penginstal atau Apigee:
- Pelanggan
- Penginstal
- Apigee
Cara menggunakan file .properties
Sebagai pelanggan, Anda hanya dapat mengubah file .properties di /opt/apigee/customer/application saat ini. Setiap komponen memiliki file .properties sendiri di direktori tersebut. Misalnya, router.properties dan management-server.properties.
Misalnya, untuk membuat file .properties:
- Buat file di editor sebagai pengguna mana pun.
- Hapus pemilik file ke apigee:apigee atau, jika Anda mengubah pengguna menjalankan layanan Edge dari pengguna apigee, mengubah file ke pengguna yang menjalankan layanan Edge.
Guna menetapkan properti untuk komponen, edit file .properties yang sesuai untuk menetapkan token. lalu mulai ulang komponennya:
> /opt/apigee/apigee-service/bin/apigee-service component restart
Misalnya, setelah mengedit router.properties, mulai ulang Router:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
Saat Anda mengupgrade Edge, file .properties di /opt/apigee/customer/application telah dibaca. Artinya, upgrade akan mempertahankan properti apa pun yang Anda tetapkan di komponen.
Lokasi file .properties
Ada tiga direktori tingkat atas untuk file .properties untuk Edge komponen: pemilik instalasi, dan pelanggan. Lokasi default ditampilkan sebagai berikut tabel:
Peringatan: Pelanggan Edge hanya dapat mengubah file .properties di bagian /opt/apigee/customer. Sementara Anda dapat melihat file di bawah komponen dan direktori instalasi, tidak mengubah file apa pun.
|
Channel |
Direktori Root Token Default |
|---|---|
|
Komponen |
/opt/apigee/<prefix>-<component>/conf dengan /<prefix>-<component> mengidentifikasi komponen, seperti edge-router atau apigee-cassandra. |
|
Penginstalan |
/opt/apigee/token |
|
Pelanggan |
/opt/apigee/customer |
Menentukan nilai token saat ini
Sebelum menetapkan token di file .properties untuk komponen, Anda dapat menentukan nilainya saat ini terlebih dahulu dengan menggunakan perintah berikut:
> /opt/apigee/apigee-service/bin/apigee-service comp configure -search token
dengan comp adalah nama komponen, dan token adalah token yang akan diperiksa.
Perintah ini menelusuri hierarki file .properties untuk menentukan nilai token saat ini.
Misalnya, untuk memeriksa nilai token conf_http_HTTPRequest.line.limit saat ini untuk {i>Router<i}:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Anda akan melihat output dalam bentuk:
Found key conf_http_HTTPRequest.line.limit, with value, 4k, in /opt/apigee/edge-router/token/default.properties
Menetapkan token di file .properties
Untuk mengganti nilai token:
- Edit file .properties untuk untuk menyetel nilai token. Jika file tidak ada, buat file tersebut.
- Mulai ulang komponen.
- Periksa nilai token.
Misalnya, untuk menetapkan batas baris permintaan bagi Router Edge:
- Edit /opt/apigee/customer/application/router.properties
untuk menetapkan token conf_http_HTTPRequest.line.limit:
conf_http_HTTPRequest.line.limit=8k - Mulai ulang Router Edge:
> /opt/apigee/apigee-service/bin/apigee-service edge-router mulai ulang - Periksa nilai token:
> /opt/apigee/apigee-service/bin/apigee-service edge-router configure -search conf_http_HTTPRequest.line.limit
Menetapkan token yang menggunakan beberapa nilai
Beberapa token mengambil daftar nilai yang dipisahkan koma. Misalnya, token conf_security_rbac.restricted.resources mengambil daftar URI yang dibatasi sehingga hanya sysadmin yang dapat memanggilnya. Untuk melihat nilai conf_security_rbac.restricted.resources:
> cd /opt/apigee/edge-management-server > grep -ri "conf_security_rbac.restricted.resources" *
Outputnya berisi hal berikut:
token/default.properties:conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status
Untuk menyetel token yang menggunakan daftar nilai, tambahkan nilai baru ke nilai saat ini token Anda di file .properties. Oleh karena itu, untuk menambahkan URI /myuri/* ke conf_security_rbac.restricted.resources, edit /opt/apigee/customer/application/management-server.properties seperti yang ditunjukkan di bawah ini:
conf_security_rbac.restricted.resources=/environments,/environments/*,/environments/*/virtualhosts,/environments/*/virtualhosts/*,/pods,/environments/*/servers,/rebuildindex,/users/*/status,/myuri/*
Menemukan token
Pada umumnya, token yang perlu Anda tetapkan diidentifikasi dalam panduan ini. Namun, jika Anda ingin Untuk menentukan token yang digunakan guna mengganti properti, jalankan grep di folder source komponen.
Misalnya, jika Anda mengetahui bahwa dalam rilis Edge sebelumnya, Anda menetapkan properti session.maxAge dan ingin mengetahui nilai token yang digunakan untuk menetapkannya, lalu grep untuk properti di direktori /opt/apigee/edge-ui/source:
> grep -ri "session.maxAge" /opt/apigee/edge-ui/source
Anda akan melihat hasil dalam bentuk:
/opt/apigee/edge-ui/source/conf/application.conf:session.maxAge={T}conf_application_session.maxage{/T}
String di antara tag {T}{/T} adalah token yang Anda tetapkan di file .properties.
Menyetel token yang saat ini diberi komentar keluar
Beberapa token dijadikan komentar dalam file konfigurasi Edge. Jika Anda mencoba menetapkan token yang diberi komentar, setelan akan diabaikan.
Untuk menetapkan token yang diberi komentar, Anda menggunakan sintaksis khusus, berupa:
conf/file.extension+propertyName=propertyValue
Misalnya, Anda ingin menetapkan properti bernama HTTPClient.proxy.host di Pesan Pemroses. Lalu, Anda akan menjalankan grep untuk untuk menentukan tokennya:
> cd /opt/apigee/edge-message-processor > grep -ri "HTTPClient.proxy.host" *
Perintah grep menampilkan menghasilkan bentuk yang menyertakan nilai token. Perhatikan bagaimana nama properti diberi {i>comment<i}, seperti yang ditunjukkan dengan awalan # pada nama properti:
source/conf/http.properties:#HTTPClient.proxy.host={T}conf_http_HTTPClient.proxy.host{/T}
token/default.properties:conf_http_HTTPClient.proxy.host=
conf/http.properties:#HTTPClient.proxy.host=
Untuk menetapkan properti, edit /opt/apigee/customer/application/message-processor.properties untuk menetapkan properti sebagai:
conf/http.properties+HTTPClient.proxy.host=myhost.name.com
Perhatikan bagaimana nama properti diawali dengan conf/http.properties+, yaitu lokasi dan nama file konfigurasi yang berisi properti yang diikuti dengan "+".
Setelah memulai ulang Pemroses Pesan, periksa file /opt/apigee/edge-message-processor/conf/http.properties:
> cat /opt/apigee/edge-message-processor/conf/http.properties
Di akhir file, Anda akan melihat properti yang ditetapkan, dalam bentuk:
conf/http.properties:HTTPClient.proxy.host=myhost.name.com