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
-
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")
-
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
-
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
- Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
-
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
-
Ubah direktori ke direktori dasar menggunakan perintah
cd
. -
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 keapigeectl
menggunakan perintah berikut:mv apigeectl_1.11.2-d591b23_linux_64/ apigeectl
-
Ubah ke direktori menggunakan perintah berikut:
cd ./apigeectl
Direktori ini adalah direktori utama
apigeectl
. Di sinilah ada perintahapigeectl
yang dapat dieksekusi. - Verifikasi versi
apigeectl
dengan perintahversion
:./apigeectl version
Version: 1.11.2
-
Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
export APIGEECTL_HOME=$PWD
-
Pastikan variabel tersebut menyimpan jalur yang benar menggunakan perintah berikut:
echo $APIGEECTL_HOME
Mac OS
-
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")
-
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
-
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
- Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
-
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
-
Ubah direktori ke direktori dasar menggunakan perintah
cd
. -
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 keapigeectl
menggunakan perintah berikut:mv apigeectl_1.11.2-d591b23_mac_64 apigeectl
-
Ubah ke direktori menggunakan perintah berikut:
cd ./apigeectl
Direktori ini adalah direktori utama
apigeectl
. Di sinilah ada perintahapigeectl
yang dapat dieksekusi. - Verifikasi versi
apigeectl
dengan perintahversion
:./apigeectl version
Version: 1.11.2
-
Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
export APIGEECTL_HOME=$PWD
-
Pastikan variabel tersebut menyimpan jalur yang benar menggunakan perintah berikut:
echo $APIGEECTL_HOME
Windows
-
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
-
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
-
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
- Buat direktori pada sistem Anda sebagai direktori dasar untuk Penginstalan hybrid Apigee.
-
Ekstrak konten file .zip yang didownload ke direktori saat ini menggunakan perintah berikut:
tar xvzf filename.zip -C path-to-base-directory
-
Ubah direktori ke direktori dasar menggunakan perintah
cd
. -
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 menjadiapigeectl
menggunakan perintah berikut berikut:rename apigeectl_1.11.2-d591b23_windows_64 apigeectl
-
Ubah ke direktori menggunakan perintah berikut:
cd .\apigeectl
Direktori ini adalah direktori utama
apigeectl
. Di sinilah ada perintahapigeectl
yang dapat dieksekusi. - Verifikasi versi
apigeectl
dengan perintahversion
:./apigeectl version
Version: 1.11.2
-
Buat variabel lingkungan untuk menyimpan jalur direktori utama ini menggunakan perintah berikut:
set APIGEECTL_HOME=%CD%
-
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
-
Pastikan Anda berada di direktori dasar (direktori tempat direktori
apigeectl
) dengan menggunakan perintah berikut:cd $APIGEECTL_HOME/..
-
Buat folder baru bernama
hybrid-files
menggunakan perintah berikut. Anda dapat memberi ke direktori dengan nama apa pun yang Anda inginkan, tetapi dalam dokumen, namahybrid-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 dariapigeectl
penginstalan software.mkdir hybrid-files
-
Struktur direktori saat ini sekarang terlihat seperti berikut:
pwd && ls
/hybrid-base-directory apigeectl hybrid-files
-
Ubah direktori ke folder
hybrid-files
menggunakan perintah berikut:cd hybrid-files
-
Buat variabel lingkungan untuk menyimpan jalur ke direktori
hybrid-files
Anda:export HYBRID_FILES=$PWD
echo $HYBRID_FILES
-
Di dalam direktori
hybrid-files
, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:mkdir overrides
mkdir certs
-
Di dalam direktori
hybrid-files
, buat link simbolis berikut untuk$APIGEECTL_HOME
. Link ini memungkinkan Anda menjalankan perintahapigeectl
dari dalam Direktorihybrid-files
seperti dalam contoh berikut menampilkan:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins -
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
-
Pastikan Anda berada di direktori dasar (direktori tempat direktori
apigeectl
) dengan menggunakan perintah berikut:cd $APIGEECTL_HOME/..
-
Buat folder baru bernama
hybrid-files
menggunakan perintah berikut. Anda dapat memberi ke direktori dengan nama apa pun yang Anda inginkan, tetapi dalam dokumen, namahybrid-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 dariapigeectl
penginstalan software.mkdir hybrid-files
-
Struktur direktori saat ini sekarang terlihat seperti berikut:
pwd && ls
/hybrid-base-directory apigeectl hybrid-files
-
Ubah direktori ke folder
hybrid-files
menggunakan perintah berikut:cd hybrid-files
-
Buat variabel lingkungan untuk menyimpan jalur ke direktori
hybrid-files
Anda:export HYBRID_FILES=$PWD
echo $HYBRID_FILES
-
Di dalam direktori
hybrid-files
, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:mkdir overrides
mkdir certs
-
Di dalam direktori
hybrid-files
, buat link simbolis berikut untuk$APIGEECTL_HOME
. Link ini memungkinkan Anda menjalankan perintahapigeectl
dari dalam Direktorihybrid-files
seperti dalam contoh berikut menampilkan:ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins -
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
-
Pastikan Anda berada di direktori dasar (direktori tempat direktori
apigeectl
) dengan menggunakan perintah berikut:cd %APIGEECTL_HOME%\..
-
Buat folder baru bernama
hybrid-files
menggunakan perintah berikut. Anda dapat memberi ke direktori dengan nama apa pun yang Anda inginkan, tetapi dalam dokumen, namahybrid-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 dariapigeectl
penginstalan software.mkdir hybrid-files
-
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
-
Ubah direktori ke folder
hybrid-files
. -
Buat variabel lingkungan untuk menyimpan jalur ke direktori
hybrid-files
Anda:set HYBRID_FILES=%CD%
echo %HYBRID_FILES%
-
Di dalam direktori
hybrid-files
, buat kode berikut subdirektori untuk mengatur file yang nantinya akan Anda buat:mkdir overrides
mkdir certs
-
Di dalam direktori
hybrid-files
, buat link simbolis berikut untuk$APIGEECTL_HOME
. Link ini memungkinkan Anda menjalankan perintahapigeectl
dari dalam Direktorihybrid-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\
-
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