Langkah 2: Menginstal dan menyiapkan GKE on-prem

Saat ini Anda melihat versi 1.1 dari dokumentasi Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.1 (unsupported)

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Langkah ini menjelaskan cara mendownload dan menginstal apigeectl di mesin admin Anthos GKE yang di-deploy di lokal. Langkah-langkahnya mencakup penyiapan direktori penginstalan, pembuatan akun layanan GCP yang diperlukan agar komponen hybrid dapat berkomunikasi, dan pembuatan 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:

1. Download paket rilis ke mesin admin GKE on-prem 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

2. Buat direktori di sistem Anda untuk berfungsi sebagai direktori dasar untuk penginstalan Apigee Hybrid.

3. 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

4. cd ke direktori dasar.

5. Konten tar secara default diekstrak ke dalam direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.0.0-f7b96a8_linux_64. Ganti nama direktori tersebut menjadi apigeectl:

   mv apigeectl_1.0.0-f7b96a8_linux_64 apigeectl

6. cdke dalam direktori. Contoh:
cd ./apigeectl

Direktori ini akan menjadi direktori beranda apigeectl. Di sinilah perintah yang dapat dieksekusi apigeectl berada.

7. Buat variabel lingkungan untuk menyimpan jalur direktori beranda ini:

   export APIGEECTL_HOME=$PWD

8. Pastikan variabel menyimpan jalur yang benar:

   echo $APIGEECTL_HOME

Menyiapkan struktur direktori project

Struktur direktori yang dijelaskan di bawah adalah pendekatan yang disarankan. Hal ini memisahkan software rilis Apigee hybrid dari file konfigurasi yang harus Anda buat. Dengan menggunakan variabel $APIGEECTL_HOME dan link simbolis yang akan Anda buat, Anda dapat dengan mudah beralih ke versi software baru jika Anda memilih untuk melakukannya. Lihat juga Mengupgrade Apigee Hybrid.

CATATAN: Untuk tujuan panduan memulai ini, langkah-langkah penginstalan berikutnya mengasumsikan bahwa Anda membuat struktur project seperti yang dijelaskan di bawah. Jika mengikuti struktur yang disarankan ini, Anda dapat menyalin dan menempelkan sebagian besar perintah penginstalan langsung ke terminal.

1. Pastikan Anda berada di direktori dasar (direktori tempat direktori apigeectl berada).
2. Buat folder baru bernama hybrid-files. Anda dapat memberi direktori nama apa pun yang diinginkan, tetapi dalam dokumen, nama hybrid-files akan digunakan secara konsisten. Nanti, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Folder ini memungkinkan Anda menyimpan file konfigurasi secara terpisah dari penginstalan software apigeectl:

   mkdir hybrid-files

3. Struktur direktori saat ini akan terlihat seperti ini:

   pwd && ls
   /hybrid-base-directory
     apigeectl
     hybrid-files

4. cd ke folder hybrid-files:

   cd hybrid-files

5. Di dalam direktori hybrid-files, buat tiga subdirektori berikut untuk mengatur file yang akan Anda buat nanti:

   mkdir overrides
   mkdir service-accounts
   mkdir certs

6. Di dalam direktori hybrid-files, buat link simbolis ke $APIGEECTL_HOME. Link simbolis ini memungkinkan Anda menjalankan perintah apigeectl dari dalam direktori hybrid-files:

   ln -s $APIGEECTL_HOME/tools tools
   ln -s $APIGEECTL_HOME/config config
   ln -s $APIGEECTL_HOME/templates templates
   ln -s $APIGEECTL_HOME/plugins plugins

7. Untuk memeriksa apakah symlink 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 untuk mengizinkan komponen hybrid berkomunikasi dengan melakukan panggilan API yang diotorisasi. Pada langkah ini, Anda akan menggunakan alat command line Apigee Hybrid untuk membuat serangkaian akun layanan. Alat ini juga mendownload kunci pribadi akun layanan untuk Anda. Kemudian, Anda harus menambahkan kunci ini ke file konfigurasi cluster hybrid Apigee.

Klik untuk mempelajari lebih lanjut

Tabel berikut menjelaskan akun layanan yang diperlukan oleh komponen hybrid untuk melakukan komunikasi yang sah. Lihat juga Tentang akun layanan.

Komponen^*	Peran	Diperlukan untuk penginstalan dasar?	Deskripsi
apigee-cassandra	Storage Object Admin		Mengizinkan pencadangan Cassandra ke Google Cloud Storage, seperti yang dijelaskan dalam Pencadangan dan pemulihan.
apigee-logger	Penulis Log		Mengizinkan pengumpulan data logging, seperti yang dijelaskan dalam Logging. Hanya diperlukan untuk penginstalan cluster non-GKE.
apigee-mart	Tidak ada peran		Mengizinkan autentikasi layanan MART. Akun layanan ini tidak boleh memiliki peran yang terkait dengannya; oleh karena itu, saat Anda membuat akun layanan ini, jangan tetapkan peran kepadanya.
apigee-metrics	Penulis Metrik Pemantauan		Mengizinkan pengumpulan data metrik, seperti yang dijelaskan dalam Pengumpulan metrik
apigee-org-admin	Apigee Organization Admin		Memungkinkan Anda memanggil getSyncAuthorization API dan setSyncAuthorization API. Anda tidak dapat membuat akun layanan ini dengan alat create-service-account.
apigee-synchronizer	Apigee Synchronizer Manager		Memungkinkan sinkronisasi mendownload paket proxy dan data konfigurasi lingkungan. Juga memungkinkan pengoperasian fitur rekaman aktivitas.
apigee-udca	Apigee Analytics Agent		Memungkinkan transfer data status deployment, analisis, dan rekaman aktivitas ke bidang pengelolaan.
^* Nama ini digunakan dalam nama file kunci akun layanan yang didownload.

Buat kunci:

1. Pastikan Anda berada di direktori base_directory/hybrid-files:
2. Jalankan perintah berikut dari dalam direktori hybrid-files. Perintah ini membuat akun layanan untuk komponen apigee-metrics dan menempatkan kunci yang didownload di 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 dibuat, maka alat hanya akan membuatnya, dan Anda tidak perlu melakukan tindakan lebih lanjut.

   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.
    

3. 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

4. Pastikan kunci akun layanan telah dibuat. Anda bertanggung jawab untuk 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

TIPS: Apigee hybrid menyertakan validator yang memeriksa file kunci dan izin akun layanan Anda saat apigeectl menerapkan komponen runtime Apigee hybrid ke cluster Anda. Validasi ini diaktifkan secara default. Untuk mengetahui informasi selengkapnya, lihat Validasi akun layanan.

Membuat sertifikat TLS

Anda diwajibkan untuk memberikan sertifikat TLS untuk gateway ingress MART dan runtime dalam konfigurasi hybrid Apigee Anda. Kredensial yang digunakan untuk gateway MART harus diizinkan 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. Di Langkah 3: Konfigurasi cluster, Anda akan menambahkan jalur file ke file konfigurasi cluster.

Buat kredensial TLS untuk gateway runtime

Gateway ingress runtime (gateway yang menangani traffic proxy API) memerlukan pasangan kunci/sertifikat TLS. Untuk penginstalan panduan memulai ini, Anda dapat menggunakan kredensial yang ditandatangani sendiri. Pada langkah-langkah berikut, openssl digunakan untuk membuat kredensial.

1. Pastikan Anda berada di direktori base_directory/hybrid-files.
2. 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 kunci/sertifikat yang ditandatangani sendiri yang dapat Anda gunakan untuk penginstalan panduan memulai. CN mydomain.net dapat berupa nilai apa pun yang Anda inginkan untuk kredensial yang ditandatangani sendiri.

3. Periksa untuk memastikan file berada di direktori ./certs:

   ls ./certs
     keystore.pem
     keystore.key

   Dengan keystore.pem adalah file sertifikat TLS yang ditandatangani sendiri dan keystore.key adalah file kunci.

Membuat kredensial TLS untuk gateway MART

Seperti yang disebutkan dalam Sebelum memulai, Anda harus menggunakan pasangan kunci/sertifikat TLS yang sah untuk konfigurasi gateway MART. Jika Anda belum melakukannya, dapatkan atau buat kredensial ini sekarang.

1. Dapatkan atau buat pasangan kunci/sertifikat TLS yang diizinkan oleh certificate authority. Contoh diberikan untuk menunjukkan cara mendapatkan kredensial ini menggunakan CA Let's Encrypt. Perhatikan bahwa nama umum (CN) sertifikat harus berupa nama DNS yang valid. Untuk mengetahui langkah-langkah contohnya, lihat Mendapatkan kredensial TLS: Contoh.
2. Salin kredensial ke direktori base_directory/hybrid-files/certs.
3. Setelah selesai, Anda akan memiliki dua pasang file kredensial di direktori ./certs. Contoh:

   ls ./certs
     fullchain.pem
     privkey.key
     keystore.pem
     keystore.key

   Dengan fullchain.pem adalah file sertifikat TLS yang sah dan privkey.key adalah file kunci yang sah.

Ringkasan

Sekarang Anda memiliki basis utama tempat Anda dapat 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 (BERIKUTNYA) Langkah 3: Konfigurasi cluster 4