Halaman ini diterjemahkan oleh Cloud Translation API.

Langkah 2: Instal dan siapkan GKE secara lokal

Langkah ini menjelaskan cara mendownload dan menginstal apigeectl di mesin admin lokal yang di-deploy Anthos GKE. Langkah-langkahnya mencakup menyiapkan direktori penginstalan, membuat akun layanan GCP yang diperlukan untuk komponen hybrid untuk 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.2.0/apigeectl_mac_64.tar.gz

Linux 64 bit

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

Mac 32 bit:

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

Linux 32 bit

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

Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
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.
Konten {i>tar<i} secara default diperluas ke direktori dengan versi dan platform di nama. Misalnya: ./apigeectl_1.0.0-f7b96a8_linux_64. Mengganti nama direktori tersebut ke apigeectl:
```
mv apigeectl_1.0.0-f7b96a8_linux_64 apigeectl
```
cdke dalam direktori. Contoh:

cd ./apigeectl

Direktori ini akan menjadi direktori utama apigeectl. Di sinilah apigeectl yang dapat dieksekusi.

Buat variabel lingkungan untuk menyimpan jalur direktori utama ini:
```
export APIGEECTL_HOME=$PWD
```
Pastikan variabel tersebut memiliki jalur yang benar:
```
echo $APIGEECTL_HOME
```

Menyiapkan struktur direktori project

Struktur direktori yang dijelaskan di bawah ini 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 akan Anda buat, Anda dapat dengan mudah beralih ke versi perangkat lunak baru jika Anda mau. Lihat juga Mengupgrade Apigee Hybrid.

Pastikan Anda berada di direktori dasar (direktori tempat direktori apigeectl ada).
Buat folder baru bernama hybrid-files. Anda dapat memberikan direktori pada nama yang Anda inginkan, tetapi dalam dokumen, nama hybrid-files akan digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Folder ini memungkinkan Anda menyimpan file konfigurasi terpisah dari software apigeectl penginstalan:
```
mkdir hybrid-files
```

Struktur direktori saat ini sekarang terlihat seperti ini:

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

cd ke folder hybrid-files:
```
cd hybrid-files
```
Di dalam direktori hybrid-files, buat tiga berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:
```
mkdir overrides
mkdir service-accounts
mkdir certs
```
Di dalam direktori hybrid-files, buat link simbolis ke $APIGEECTL_HOME. Symlink ini memungkinkan Anda menjalankan perintah apigeectl dari dalam hybrid-files direktori:
```
ln -s $APIGEECTL_HOME/tools tools
ln -s $APIGEECTL_HOME/config config
ln -s $APIGEECTL_HOME/templates templates
ln -s $APIGEECTL_HOME/plugins plugins
```
Untuk memeriksa apakah symlink dibuat dengan benar, jalankan perintah ini dan pastikan pastikan jalur tautan mengarah ke lokasi yang benar:
```
ls -l | grep ^l
```

Membuat akun layanan

Apigee Hybrid menggunakan layanan GCP akun Google untuk memungkinkan komponen hybrid 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 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 diwajibkan oleh komponen campuran untuk melakukan komunikasi resmi. Lihat artikel Tentang akun layanan.

Komponen^*	Peran	Deskripsi
`apigee-cassandra`	Storage Object Admin	Mengizinkan pencadangan Cassandra ke Google Cloud Storage, sebagai yang dijelaskan di Pencadangan dan pemulihan.
`apigee-logger`	Penulis Log	Mengizinkan pengumpulan data logging, seperti yang dijelaskan di Logging. Hanya diperlukan untuk non-GKE penginstalan cluster.
`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 IP eksternal mana pun yang ditetapkan pada instance tersebut.
`apigee-metrics`	Penulis Metrik Pemantauan	Mengizinkan pengumpulan data metrik, seperti yang dijelaskan dalam Metrics koleksi
`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`	Sinkronisasi Apigee Manager	Mengizinkan sinkronisasi mendownload paket proxy dan konfigurasi lingkungan layanan otomatis dan data skalabel. Juga mengaktifkan pengoperasian fitur rekaman aktivitas.
`apigee-udca`	Apigee Analytics Agent	Memungkinkan transfer data trace, analisis, dan status deployment ke manajemen pesawat terbang.
^* Nama ini digunakan di akun layanan yang didownload nama file kunci.

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 komponen apigee-metrics dan tempat kunci yang didownload di direktori ./service-accounts:

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

Saat Anda melihat permintaan 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 ini hanya 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. 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 sudah dibuat. Anda bertanggung jawab untuk menyimpan kunci pribadi 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 harus memberikan sertifikat TLS untuk gateway masuk MART dan runtime di Konfigurasi hybrid Apigee. Kredensial yang digunakan untuk gateway MART harus diotorisasi oleh {i>certificate authority<i} (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 file ke file konfigurasi cluster.

Membuat kredensial TLS untuk gateway runtime

Gateway masuk runtime (gateway yang menangani traffic proxy API) memerlukan pasangan kunci/sertifikat TLS. Untuk penginstalan panduan memulai ini, Anda dapat menggunakan tanda tangan mandiri memiliki kredensial yang lengkap. Pada langkah-langkah berikut, openssl akan 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 yang bisa Anda gunakan untuk penginstalan panduan memulai. CN mydomain.net dapat berupa nilai apa pun yang Anda inginkan kredensial yang ditandatangani sendiri.
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 diotorisasi untuk konfigurasi gateway MART. Jika Anda memiliki belum melakukannya, dapatkan atau buat kredensial tersebut sekarang.

Mendapatkan atau membuat pasangan sertifikat/kunci TLS yang diotorisasi oleh sertifikat {i>authority<i}. Tersedia contoh yang menunjukkan cara memperoleh kredensial ini menggunakan Mari kita Enkripsi CA. Perhatikan bahwa nama umum sertifikat (CN) harus berupa nama DNS yang valid. Untuk mengetahui langkah-langkah contohnya, lihat Mendapatkan kredensial TLS: Sebuah contoh.
Salin kredensial ke direktori base_directory/hybrid-files/certs.
Setelah selesai, Anda seharusnya 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 diotorisasi dan privkey.key adalah file kunci yang diotorisasi.

Ringkasan

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 akan digunakan oleh Kubernetes untuk men-deploy komponen runtime hybrid ke cluster.

1 2 (BERIKUTNYA) Langkah 3: Mengonfigurasi cluster 4