Langkah 3: Instal apigeectl

Langkah ini menjelaskan cara mendownload dan menginstal apigeectl.

Download dan instal apigeectl

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

Langkah-langkah berikut menjelaskan cara mendownload dan menginstal apigeectl:

Linux

  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
      1.11.2
  3. Download paket rilis untuk sistem operasi Anda menggunakan perintah berikut:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
  4. Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
  5. Ekstrak konten file gzip yang diunduh 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.11.2-d591b23_linux_64. Mengganti nama direktori tersebut ke apigeectl menggunakan perintah berikut:

    mv apigeectl_1.11.2-d591b23_linux_64/ apigeectl
  8. Ubah ke direktori menggunakan perintah berikut:
    cd ./apigeectl

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

  9. Verifikasi versi apigeectl dengan perintah version:
    ./apigeectl version
    Version: 1.11.2
  10. Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
    export APIGEECTL_HOME=$PWD
  11. Pastikan variabel tersebut menyimpan jalur yang benar menggunakan perintah berikut:
    echo $APIGEECTL_HOME

Mac OS

  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
      1.11.2
  3. Download paket rilis untuk sistem operasi Anda menggunakan perintah berikut:

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
  4. Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
  5. Ekstrak konten file gzip yang diunduh 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.11.2-d591b23_mac_64. Mengganti nama direktori tersebut ke apigeectl menggunakan perintah berikut:

    mv apigeectl_1.11.2-d591b23_mac_64 apigeectl
  8. Ubah ke direktori menggunakan perintah berikut:
    cd ./apigeectl

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

  9. Verifikasi versi apigeectl dengan perintah version:
    ./apigeectl version
    Version: 1.11.2
  10. Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
    export APIGEECTL_HOME=$PWD
  11. Pastikan variabel tersebut menyimpan jalur yang benar menggunakan perintah berikut:
    echo $APIGEECTL_HOME

Windows

  1. Simpan nomor versi terbaru dalam variabel menggunakan perintah berikut:
    for /f "tokens=*" %a in ('curl -s ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
    do set VERSION=%a
  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%
      1.11.2
  3. Download paket rilis untuk sistem operasi Anda menggunakan perintah berikut:

    curl -LO ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip
  4. Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
  5. Ekstrak konten file .zip yang didownload ke direktori saat ini menggunakan perintah berikut:

    tar xvzf filename.zip -C path-to-base-directory
  6. Ubah direktori ke direktori dasar menggunakan perintah cd.
  7. Konten file tar secara default diperluas ke direktori dengan versi dan platform dalam namanya. Misalnya: .\apigeectl_1.11.2-d591b23_windows_64. Ganti nama direktori tersebut menjadi apigeectl menggunakan perintah berikut berikut:

    rename apigeectl_1.11.2-d591b23_windows_64 apigeectl
  8. Ubah ke direktori menggunakan perintah berikut:
    cd .\apigeectl

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

  9. Verifikasi versi apigeectl dengan perintah version:
    ./apigeectl version
    Version: 1.11.2
  10. Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
    set APIGEECTL_HOME=%CD%
  11. 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.

Linux

  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. Buat variabel lingkungan untuk menyimpan jalur ke direktori hybrid-files Anda:
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. Di dalam direktori hybrid-files, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:
    mkdir overrides
    mkdir certs
  7. 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:
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  8. Untuk memeriksa apakah symlink dibuat dengan benar, jalankan perintah berikut dan pastikan pastikan jalur tautan mengarah ke lokasi yang benar:
    ls -l | grep ^l

Mac OS

  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. Buat variabel lingkungan untuk menyimpan jalur ke direktori hybrid-files Anda:
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. Di dalam direktori hybrid-files, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:
    mkdir overrides
    mkdir certs
  7. 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:
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  8. Untuk memeriksa apakah symlink dibuat dengan benar, jalankan perintah berikut dan pastikan pastikan jalur tautan mengarah ke lokasi yang benar:
    ls -l | grep ^l

Windows

  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:
    dir
     Directory of C:\Users\example\hybrid
    
    08/05/2021  01:38 PM    <DIR>          .
    08/05/2021  01:38 PM    <DIR>          ..
    08/02/2021  01:11 PM    <DIR>          apigeectl
    08/02/2021  11:13 AM         5,803,963 apigeectl_1.11.2rc1-437dccc_windows_64.zip
    08/05/2021  01:38 PM    <DIR>          hybrid-files
  4. Ubah direktori ke folder hybrid-files.
  5. Buat variabel lingkungan untuk menyimpan jalur ke direktori hybrid-files Anda:
    set HYBRID_FILES=%CD%
    echo %HYBRID_FILES%
  6. Di dalam direktori hybrid-files, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:
    mkdir overrides
    mkdir certs
  7. 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:
    mklink /d config %APIGEECTL_HOME%\config\
    mklink /d plugins %APIGEECTL_HOME%\plugins\
    mklink /d templates %APIGEECTL_HOME%\templates\
    mklink /d tools %APIGEECTL_HOME%\tools\
  8. Untuk memeriksa apakah symlink dibuat dengan benar, gunakan dir:
    dir
     Directory of C:\Users\example\hybrid\hybrid-files
    
    08/05/2021  01:56 PM    <DIR>          .
    08/05/2021  01:56 PM    <DIR>          ..
    08/05/2021  01:46 PM    <DIR>          certs
    08/05/2021  01:55 PM    <SYMLINKD>     config [C:\Users\example\hybrid\apigeectl\config\]
    08/05/2021  01:46 PM    <DIR>          overrides
    08/05/2021  01:56 PM    <SYMLINKD>     plugins [C:\Users\example\hybrid\apigeectl\plugins\]
    08/05/2021  01:56 PM    <SYMLINKD>     templates [C:\Users\example\hybrid\apigeectl\templates\]
    08/05/2021  01:56 PM    <SYMLINKD>     tools [C:\Users\example\hybrid\apigeectl\tools\]
        

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

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