Langkah 3: Instal apigeectl

Anda sedang melihat versi 1.3 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.3 (unsupported)

Versi yang didukung:

• v1.13 (terbaru)                        
• v1.12                         
• v1.11                         
• Daftar versi yang didukung

Versi yang tidak didukung:

• 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. Langkah-langkahnya mencakup menyiapkan direktori penginstalan, membuat akun layanan Google Cloud yang diperlukan agar komponen hybrid dapat berkomunikasi, dan membuat kredensial TLS yang diperlukan untuk Apigee Hybrid untuk beroperasi.

Untuk mengetahui informasi selengkapnya tentang cara menggunakan apigeectl dan kubectl untuk mengelola cluster, lihat Menghubungkan ke cluster Anda dengan kubectl

Download dan instal apigeectl

apigeectl adalah antarmuka command line (CLI) untuk menginstal dan mengelola Apigee Hybrid di cluster Kubernetes.

Langkah-langkah berikut menjelaskan cara mendapatkan apigeectl:

1. Simpan nomor versi terbaru dalam variabel menggunakan perintah berikut:

   export VERSION=$(curl -s \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

2. Pastikan variabel telah diisi dengan nomor versi menggunakan perintah berikut. Jika Anda ingin menggunakan versi yang berbeda, Anda dapat menyimpannya dalam variabel lingkungan.

   echo $VERSION

3. Download paket rilis untuk sistem operasi Anda menggunakan perintah berikut:

   Mac 64 bit:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

   Linux 64 bit:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

   Mac 32 bit:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

   Linux 32 bit:

   curl -LO \
       https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz

4. Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.

5. Ekstrak konten file gzip yang didownload ke direktori dasar yang baru saja Anda buat menggunakan perintah berikut:

   tar xvzf filename.tar.gz -C path-to-base-directory

6. Ubah direktori ke direktori dasar menggunakan perintah cd.

7. Konten {i>tar<i} secara {i>default<i} diperluas ke direktori dengan versi dan platform di namanya. Misalnya: ./apigeectl_1.0.0-f7b96a8_linux_64. Mengganti nama direktori tersebut ke apigeectl menggunakan perintah berikut:

   mv apigeectl_1.0.0-f7b96a8_linux_64 apigeectl

8. Ubah ke direktori menggunakan perintah berikut:

   cd ./apigeectl

   Direktori ini adalah direktori utama apigeectl. Di sinilah apigeectl yang dapat dieksekusi.

9. Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:

   export APIGEECTL_HOME=$PWD

10. Pastikan variabel tersebut menyimpan jalur yang benar menggunakan perintah berikut:

    echo $APIGEECTL_HOME

Menyiapkan struktur direktori project

Struktur direktori berikut adalah pendekatan yang disarankan. Memisahkan Apigee Hybrid merilis perangkat lunak dari file konfigurasi yang harus Anda buat. Melalui penggunaan Link simbol dan variabel $APIGEECTL_HOME yang Anda buat, Anda dapat dengan mudah beralih ke versi perangkat lunak baru jika Anda mau. Lihat juga Mengupgrade Apigee Hybrid.

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

1. Pastikan Anda berada di direktori dasar (direktori tempat direktori apigeectl ) dengan menggunakan perintah berikut:

   cd $APIGEECTL_HOME/..

2. Buat folder baru bernama hybrid-files menggunakan perintah berikut. Anda dapat memberi ke direktori dengan nama apa pun yang Anda inginkan, tetapi dalam dokumen, nama hybrid-files digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan TLS sertifikat dalam folder ini. Folder ini memungkinkan Anda menyimpan file konfigurasi yang terpisah dari apigeectl penginstalan software.

   mkdir hybrid-files

3. Struktur direktori saat ini sekarang terlihat seperti berikut:

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

4. Ubah direktori ke folder hybrid-files menggunakan perintah berikut:

   cd hybrid-files

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

   mkdir overrides
   mkdir service-accounts
   mkdir certs

6. Di dalam direktori hybrid-files, buat link simbolis berikut untuk $APIGEECTL_HOME. Link ini memungkinkan Anda menjalankan perintah apigeectl dari dalam Direktori hybrid-files seperti dalam contoh berikut menampilkan:

   Catatan: Jika ini bukan pertama kalinya Anda menggunakan proses ini, link simbolis berikut mungkin sudah ada. Periksa apakah tautan sudah ada dengan menggunakan perintah berikut. Jika direktori tersebut ada, lewati langkah ini.

   ls -l | grep ^l
   

   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 berikut dan pastikan pastikan jalur tautan mengarah ke lokasi yang benar:

   ls -l | grep ^l

Membuat akun layanan

Apigee Hybrid menggunakan Google Cloud akun layanan untuk memungkinkan komponen hybrid berkomunikasi dengan membuat Panggilan API. Pada langkah ini, Anda akan menggunakan alat command line hybrid Apigee untuk membuat serangkaian layanan menggunakan akun layanan. Alat ini juga mendownload kunci pribadi akun layanan untuk Anda. Anda kemudian harus menambahkan kunci ini ke file konfigurasi cluster hybrid Apigee.

Catatan: Untuk mempelajari akun layanan lebih lanjut, lihat referensi berikut:

• Tentang akun layanan
• Akun dan peran layanan yang digunakan oleh komponen campuran

Apigee menyediakan alat create-service-account, yang membuat akun layanan, menetapkan peran ke akun layanan, dan membuat serta mendownload file kunci untuk layanan akun dalam satu perintah. Untuk mempelajari konsep Google Cloud terkait, lihat Membuat serta mengelola akun layanan dan Membuat dan mengelola kunci akun layanan.

1. Pastikan Anda berada di direktori base_directory/hybrid-files yang yang dikonfigurasi di Menyiapkan struktur direktori project.
2. Jalankan perintah berikut dari dalam direktori hybrid-files. Perintah ini membuat akun layanan untuk komponen apigee-metrics dan tempat kunci yang didownload di direktori ./service-accounts.

   ./tools/create-service-account apigee-metrics ./service-accounts

   Saat Anda melihat perintah berikut, 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 ini hanya membuatnya, dan Anda tidak perlu melakukan apa pun.

   Namun, jika Anda melihat pesan dan perintah berikut, masukkan y untuk membuat kunci baru:

   [INFO]: Service account apigee-metrics@project_id. 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 menggunakan perintah berikut. Perintah create-service-account bersifat interaktif dan membutuhkan respons untuk setiap akun.

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

   ./tools/create-service-account apigee-watcher ./service-accounts

   Catatan: Cloud Pub/Sub API harus diaktifkan di project Google Cloud yang memiliki akun layanan untuk Synchronizer. Lihat Mengaktifkan API.
4. Pastikan kunci akun layanan telah dibuat menggunakan perintah berikut. Anda bertanggung jawab untuk menyimpan kunci pribadi dengan aman. Nama file kunci diawali dengan nama project Google Cloud Anda.

   ls ./service-accounts

   Hasilnya akan terlihat seperti berikut:

   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
   gcp-project-id-apigee-watcher.json

Tips: Apigee Hybrid menyertakan validator yang memeriksa akun layanan Anda file kunci dan izin saat apigeectl menerapkan komponen runtime hybrid Apigee ke cluster Anda. Validasi ini diaktifkan secara default. Untuk informasi selengkapnya, lihat Akun layanan validasi.
5. Tetapkan peran Apigee Organization Admin ke akun layanan apigee-org-admin:
6. Pastikan alamat email untuk akun layanan apigee-org-admin mengikuti pola service_account@PROJECT_ID. seperti yang ditunjukkan contoh berikut:

   gcloud iam service-accounts list --filter "apigee-org-admin"

7. Tetapkan peran dengan perintah berikut:

   gcloud projects add-iam-policy-binding $PROJECT_ID \
   --member serviceAccount:apigee-org-admin@$PROJECT_ID. --role roles/apigee.admin

   PROJECT_ID adalah project Google Cloud Anda. Jika alamat email akun layanan Anda berbeda dari pola ini, gantilah dengan sesuai.

   Output harus menyertakan daftar semua akun layanan dan perannya, termasuk berikut ini:

   - members:
     - serviceAccount:apigee-org-admin@hybrid-example-2.
     role: roles/apigee.admin

Membuat sertifikat TLS

Anda harus memberikan sertifikat TLS untuk gateway masuk runtime di Konfigurasi hybrid Apigee. Untuk tujuan panduan memulai ini (penginstalan uji coba non-produksi), gateway runtime dapat menerima kredensial yang ditandatangani sendiri. Pada langkah-langkah berikut, openssl digunakan untuk membuat kredensial yang ditandatangani sendiri.

Catatan: Dalam lingkungan produksi, Anda harus menggunakan sertifikat yang ditandatangani. Anda dapat menggunakan sertifikat dan pasangan kunci atau rahasia Kubernetes. Sebagai contoh tentang bagaimana untuk mendapatkan sertifikat TLS dari certificate authority (CA) Lets Encrypt, lihat Dapatkan kredensial TLS: Contohnya.

Pada langkah ini, Anda akan membuat file kredensial TLS dan menambahkannya ke direktori base_directory/hybrid-files/certs. Di beberapa Langkah 4: Konfigurasikan cluster, Anda akan menambahkan jalur file ke file konfigurasi cluster.

1. Pastikan Anda berada di direktori base_directory/hybrid-files yang Anda konfigurasikan di bagian Menyiapkan struktur direktori project.
2. Pastikan nama domain Anda disimpan ke lingkungan DOMAIN variabel menggunakan perintah berikut:

   echo $DOMAIN

3. Jalankan perintah berikut dari dalam direktori hybrid-files:

   openssl req  -nodes -new -x509 -keyout ./certs/keystore.key -out \
       ./certs/keystore.pem -subj '/CN='$DOMAIN'' -days 3650

   Dengan DOMAIN adalah domain yang Anda pesan untuk penginstalan hybrid Panduan memulai (hybrid) Langkah 5: Konfigurasikan DNS Anda.

   Perintah ini membuat pasangan sertifikat/kunci yang ditandatangani sendiri yang dapat Anda gunakan untuk panduan memulai penginstalan.

4. Pastikan file berada di direktori ./certs menggunakan perintah berikut:

   ls ./certs
     keystore.pem
     keystore.key

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

Anda kini memiliki basis rumah yang dapat digunakan untuk mengonfigurasi, men-deploy, dan mengelola Apigee Hybrid di cluster Kubernetes Anda. Selanjutnya, Anda akan membuat file yang digunakan oleh Kubernetes untuk men-deploy komponen runtime hybrid ke cluster.

1 2 3 (BERIKUTNYA) Langkah 4: Mengonfigurasi cluster 5