Langkah 4: Instal apigeectl

Langkah ini menjelaskan cara mendownload dan menginstal apigeectl, menyiapkan direktori penginstalan, dan membuat akun layanan Google Cloud, serta 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.

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 diisi dengan nomor versi menggunakan perintah berikut. Jika ingin menggunakan versi lain, Anda dapat menyimpannya dalam variabel lingkungan. 
    echo $VERSION
     
      1.4.0

  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 di sistem Anda untuk berfungsi sebagai direktori dasar untuk penginstalan Apigee Hybrid.

  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. Secara default, konten tar diperluas ke dalam direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.4.0-d591b23_linux_64. Ganti nama direktori tersebut menjadi apigeectl menggunakan perintah berikut:

    mv apigeectl_1.4.0-d591b23_linux_64 apigeectl
  8. Beralih ke direktori menggunakan perintah berikut: 
    cd ./apigeectl

    Direktori ini adalah direktori utama apigeectl. Di sinilah perintah yang dapat dijalankan apigeectl berada.

  9. Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut: 
    export APIGEECTL_HOME=$PWD
  10. Pastikan variabel menyimpan jalur yang benar menggunakan perintah berikut: 
    echo $APIGEECTL_HOME

Menyiapkan struktur direktori project

Struktur direktori berikut adalah pendekatan yang disarankan. File ini memisahkan software rilis Apigee hybrid dari file konfigurasi yang harus Anda buat. Melalui penggunaan variabel $APIGEECTL_HOME dan link simbolis yang Anda buat, Anda dapat dengan mudah beralih ke versi software baru jika mau. Lihat juga Mengupgrade Apigee Hybrid.

  1. Pastikan Anda berada di direktori dasar (direktori tempat direktori apigeectl berada) menggunakan perintah berikut: 
    cd $APIGEECTL_HOME/..
  2. Buat folder baru bernama hybrid-files menggunakan perintah berikut. Anda dapat memberi direktori nama apa pun yang diinginkan, tetapi dalam dokumen, nama hybrid-files 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 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 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 berikut ke $APIGEECTL_HOME. Link ini memungkinkan Anda menjalankan perintah apigeectl dari dalam direktori hybrid-files seperti yang ditunjukkan pada contoh berikut: 
    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 jalur link mengarah ke lokasi yang benar: 
    ls -l | grep ^l

Sekarang Anda memiliki basis tempat Anda dapat mengonfigurasi, men-deploy, dan mengelola Apigee hybrid di cluster Kubernetes. Selanjutnya, Anda akan membuat akun layanan dan kredensial Google Cloud yang diperlukan untuk mengonfigurasi komponen runtime campuran.

1 2 3 4 (BERIKUTNYA) Langkah 5: Siapkan akun layanan 6 7