Langkah ini menjelaskan cara mendownload dan menginstal apigeectl di mesin admin lokal yang di-deploy Anthos GKE Anda. Langkah-langkah tersebut meliputi menyiapkan direktori penginstalan, membuat akun layanan GCP yang diperlukan agar komponen hybrid dapat berkomunikasi, dan membuat kredensial TLS yang diperlukan agar Apigee Hybrid dapat beroperasi.
Mendownload dan menginstal apigeectl
apigeectl
adalah antarmuka command line (CLI) untuk menginstal dan mengelola Apigee Hybrid di cluster Kubernetes.
Untuk mendapatkan apigeectl
:
Download paket rilis ke mesin admin lokal GKE Anda:
Mac 64 bit:
curl -LO https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.1.1/apigeectl_mac_64.tar.gz
Linux 64 bit
curl -LO https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.1.1/apigeectl_linux_64.tar.gz
Mac 32 bit:
curl -LO https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.1.1/apigeectl_mac_32.tar.gz
Linux 32 bit
curl -LO https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.1.1/apigeectl_linux_32.tar.gz
- Buat direktori pada sistem Anda sebagai direktori dasar untuk penginstalan Apigee Hybrid.
-
Ekstrak konten file gzip yang didownload ke direktori dasar yang baru saja Anda buat. Contoh:
tar xvzf filename.tar.gz -C path-to-base-directory
cd
ke direktori dasar.-
Secara default, konten tar diperluas ke direktori dengan versi dan platform dalam namanya. Misalnya:
./apigeectl_1.0.0-f7b96a8_linux_64
. Ganti nama direktori tersebut menjadiapigeectl
:mv apigeectl_1.0.0-f7b96a8_linux_64 apigeectl
cd
ke direktori. Contoh:- Buat variabel lingkungan untuk menyimpan jalur direktori utama ini:
export APIGEECTL_HOME=$PWD
- Pastikan variabel memiliki jalur yang benar:
echo $APIGEECTL_HOME
cd ./apigeectl
Direktori ini akan menjadi direktori utama apigeectl
. Di sinilah perintah apigeectl
yang dapat dieksekusi berada.
Menyiapkan struktur direktori project
Struktur direktori yang dijelaskan di bawah ini adalah pendekatan yang disarankan. Ini memisahkan software rilis hybrid Apigee dari file konfigurasi yang harus Anda buat. Melalui penggunaan variabel
$APIGEECTL_HOME
dan link simbolis yang akan dibuat, Anda dapat dengan mudah
beralih ke versi software baru jika ingin. Lihat juga Mengupgrade Apigee Hybrid.
- Pastikan Anda berada di direktori dasar (direktori tempat direktori
apigeectl
berada). - Buat folder baru bernama
hybrid-files
. Anda dapat memberikan nama apa pun yang diinginkan ke direktori, tetapi dalam dokumen, namahybrid-files
akan digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Dengan folder ini, Anda dapat memisahkan file konfigurasi dari penginstalan softwareapigeectl
:mkdir hybrid-files
- Struktur direktori saat ini sekarang terlihat seperti ini:
pwd && ls
/hybrid-base-directory apigeectl hybrid-files cd
ke dalam folderhybrid-files
:cd hybrid-files
- Di dalam direktori
hybrid-files
, buat tiga subdirektori berikut untuk mengatur file yang akan Anda buat nanti:mkdir overrides
mkdir service-accounts
mkdir certs
- Dalam direktori
hybrid-files
, buat link simbolis ke$APIGEECTL_HOME
. Symlink ini memungkinkan Anda menjalankan perintahapigeectl
dari dalam direktorihybrid-files
:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins - Untuk memeriksa apakah symlink telah dibuat dengan benar, jalankan perintah ini dan pastikan
jalur link mengarah ke lokasi yang benar:
ls -l | grep ^l
Membuat akun layanan
Apigee Hybrid menggunakan akun layanan GCP agar komponen hybrid dapat berkomunikasi dengan melakukan panggilan API yang diotorisasi. Pada langkah ini, Anda akan menggunakan alat command line hybrid Apigee untuk membuat kumpulan akun layanan. Alat ini juga akan mendownload kunci pribadi akun layanan untuk Anda. Kemudian, Anda harus menambahkan kunci ini ke file konfigurasi cluster hybrid Apigee.
Buat kunci:
- Pastikan Anda berada di direktori
base_directory/hybrid-files
: - Jalankan perintah berikut dari dalam direktori
hybrid-files
. Perintah ini membuat akun layanan untuk komponenapigee-metrics
dan menempatkan kunci yang didownload dalam direktori./service-accounts
:./tools/create-service-account apigee-metrics ./service-accounts
Saat Anda melihat perintah ini, masukkan
y
:[INFO]: gcloud configured project ID is project_id. Press: y to proceed with creating service account in project: project_id Press: n to abort.
Jika ini adalah pertama kalinya SA dengan nama persis yang ditetapkan oleh alat tersebut dibuat, maka alat tersebut hanya akan membuatnya, dan Anda tidak perlu melakukan apa pun.
Namun, jika Anda melihat pesan dan perintah berikut, pilih
y
untuk membuat kunci baru:[INFO]: Service account apigee-metrics@project_id.iam.gserviceaccount.com already exists. ... [INFO]: The service account might have keys associated with it. It is recommended to use existing keys. Press: y to generate new keys.(this does not de-activate existing keys) Press: n to skip generating new keys.
- Sekarang, buat akun layanan lainnya:
./tools/create-service-account apigee-synchronizer ./service-accounts
./tools/create-service-account apigee-udca ./service-accounts
./tools/create-service-account apigee-mart ./service-accounts
./tools/create-service-account apigee-cassandra ./service-accounts
./tools/create-service-account apigee-logger ./service-accounts
- Pastikan kunci akun layanan telah dibuat. Anda bertanggung jawab menyimpan kunci pribadi ini dengan aman. Nama file kunci diawali dengan nama project GCP Anda.
Contoh:
ls ./service-accounts gcp-project-id-apigee-cassandra.json gcp-project-id-apigee-logger.json gcp-project-id-apigee-mart.json gcp-project-id-apigee-metrics.json gcp-project-id-apigee-synchronizer.json gcp-project-id-apigee-udca.json
Membuat sertifikat TLS
Anda wajib memberikan sertifikat TLS untuk MART dan gateway ingress runtime dalam konfigurasi hybrid Apigee. Kredensial yang digunakan untuk gateway MART harus diberi otorisasi oleh certificate authority (CA). Untuk tujuan panduan memulai ini (penginstalan uji coba non-produksi), gateway runtime dapat menerima kredensial yang ditandatangani sendiri.
Pada langkah ini, Anda akan membuat file kredensial TLS dan menambahkannya ke
direktori base_directory/hybrid-files/certs
.
Pada Langkah 3: Konfigurasikan cluster, Anda akan menambahkan jalur file
ke file konfigurasi cluster.
Membuat kredensial TLS untuk gateway runtime
Gateway masuk runtime (gateway yang menangani traffic proxy API) memerlukan pasangan sertifikat/kunci TLS. Untuk penginstalan panduan memulai ini, Anda dapat menggunakan kredensial yang ditandatangani sendiri. Pada langkah-langkah berikut, openssl digunakan untuk membuat kredensial.
- Pastikan Anda berada di direktori
base_directory/hybrid-files
. - Jalankan perintah berikut dari dalam direktori
hybrid-files
:openssl req -nodes -new -x509 -keyout ./certs/keystore.key -out \ ./certs/keystore.pem -subj '/CN=mydomain.net' -days 3650
Perintah ini membuat pasangan sertifikat/kunci yang ditandatangani sendiri dan dapat digunakan untuk penginstalan panduan memulai. CN
mydomain.net
dapat berupa nilai apa pun yang Anda inginkan untuk kredensial yang ditandatangani sendiri. - Periksa untuk memastikan file berada di direktori
./certs
:ls ./certs
keystore.pem keystore.keyDengan
keystore.pem
adalah file sertifikat TLS yang ditandatangani sendiri dankeystore.key
adalah file kunci.
Membuat kredensial TLS untuk gateway MART
Seperti disebutkan di bagian Sebelum memulai, Anda harus menggunakan pasangan sertifikat/kunci TLS resmi untuk konfigurasi gateway MART. Jika belum melakukannya, dapatkan atau buat kredensial ini sekarang.
- Dapatkan atau buat pasangan sertifikat/kunci TLS yang diotorisasi oleh certificate authority. Berikut adalah contoh yang menunjukkan cara mendapatkan kredensial ini menggunakan Let's Encrypt CA. Perhatikan bahwa nama umum sertifikat (CN) harus berupa nama DNS yang valid. Untuk mengetahui contoh langkah-langkahnya, lihat Mendapatkan kredensial TLS: Contoh.
- Salin kredensial ke direktori
base_directory/hybrid-files/certs
. - Setelah selesai, Anda akan memiliki dua pasang file kredensial di direktori
./certs
. Contoh:ls ./certs
fullchain.pem privkey.key keystore.pem keystore.keyDengan
fullchain.pem
adalah file sertifikat TLS yang diotorisasi danprivkey.key
adalah file kunci yang diotorisasi.
Ringkasan
Anda kini memiliki home base yang dapat digunakan untuk mengonfigurasi, men-deploy, dan mengelola Apigee Hybrid di cluster Kubernetes Anda. Selanjutnya, Anda akan membuat file yang akan digunakan oleh Kubernetes untuk men-deploy komponen runtime hybrid ke cluster.
1 2 (NEXT) Langkah 3: Konfigurasi cluster 4