Langkah 3: Instal apigeectl

Saat ini Anda sedang melihat versi 1.11 dokumentasi hybrid Apigee. Untuk mengetahui informasi selengkapnya, lihat Versi yang didukung.

Version 1.11 

Versi yang didukung:

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

Versi yang tidak didukung:

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

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 ingin menggunakan versi lain, 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 di 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 tar secara default diperluas menjadi direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.11.2-d591b23_linux_64. Ganti nama direktori tersebut menjadi 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 perintah yang dapat dieksekusi apigeectl berada.

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 memiliki 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 ingin menggunakan versi lain, 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 di 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 tar secara default diperluas menjadi direktori dengan versi dan platform dalam namanya. Misalnya: ./apigeectl_1.11.2-d591b23_mac_64. Ganti nama direktori tersebut menjadi 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 perintah yang dapat dieksekusi apigeectl berada.

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 memiliki 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 ingin menggunakan versi lain, 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 di 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 yang mencantumkan versi dan platform dalam namanya. Misalnya: .\apigeectl_1.11.2-d591b23_windows_64. Ganti nama direktori tersebut menjadi apigeectl menggunakan perintah 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 perintah yang dapat dieksekusi apigeectl berada.

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 memiliki jalur yang benar menggunakan perintah berikut:

    echo %APIGEECTL_HOME%

Menyiapkan struktur direktori project

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

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

Linux

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

   cd $APIGEECTL_HOME/..

2. Buat folder baru bernama hybrid-files menggunakan perintah berikut. Anda dapat memberi nama direktori sesuai keinginan, tetapi dalam dokumen, nama hybrid-files digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Folder ini memungkinkan Anda memisahkan file konfigurasi 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. 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 subdirektori berikut untuk mengatur file yang nantinya akan Anda buat:

   mkdir overrides
   mkdir certs

7. 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 contoh berikut:

   Catatan: Jika ini bukan pertama kalinya Anda menggunakan proses ini, link simbolis berikut mungkin sudah ada. Periksa apakah link sudah ada menggunakan perintah berikut atau belum. 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

8. Untuk memeriksa apakah symlink dibuat dengan benar, jalankan perintah berikut dan pastikan jalur link mengarah ke lokasi yang benar:

   ls -l | grep ^l

Mac OS

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

   cd $APIGEECTL_HOME/..

2. Buat folder baru bernama hybrid-files menggunakan perintah berikut. Anda dapat memberi nama direktori sesuai keinginan, tetapi dalam dokumen, nama hybrid-files digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Folder ini memungkinkan Anda memisahkan file konfigurasi 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. 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 subdirektori berikut untuk mengatur file yang nantinya akan Anda buat:

   mkdir overrides
   mkdir certs

7. 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 contoh berikut:

   Catatan: Jika ini bukan pertama kalinya Anda menggunakan proses ini, link simbolis berikut mungkin sudah ada. Periksa apakah link sudah ada menggunakan perintah berikut atau belum. 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

8. Untuk memeriksa apakah symlink dibuat dengan benar, jalankan perintah berikut dan pastikan jalur link mengarah ke lokasi yang benar:

   ls -l | grep ^l

Windows

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

   cd %APIGEECTL_HOME%\..

2. Buat folder baru bernama hybrid-files menggunakan perintah berikut. Anda dapat memberi nama direktori sesuai keinginan, tetapi dalam dokumen, nama hybrid-files digunakan secara konsisten. Kemudian, Anda akan menyimpan file konfigurasi, kunci akun layanan, dan sertifikat TLS di folder ini. Folder ini memungkinkan Anda memisahkan file konfigurasi dari penginstalan software apigeectl.

   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 subdirektori berikut untuk mengatur file yang nantinya akan Anda buat:

   mkdir overrides
   mkdir certs

7. 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 contoh berikut:
   Catatan: Anda memerlukan hak istimewa administrator di komputer Windows untuk menjalankan perintah mklink. Anda dapat melakukannya dengan menjalankan terminal perintah sebagai administrator atau dengan menggunakan perintah runas. Contoh:

   runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
   

   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\]
       

Sekarang Anda memiliki database utama yang dapat digunakan untuk 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 hybrid.

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