このステップでは、apigeectl をダウンロードしてインストールする方法について説明します。
apigeectl
のダウンロードとインストール
apigeectl
は、Apigee ハイブリッドを Kubernetes クラスタにインストールして管理するためのコマンドライン インターフェース(CLI)です。
次の手順では、apigeectl
をダウンロードしてインストールする方法について説明します。
Linux
-
次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_linux_64.tar.gz
- システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
-
次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベース ディレクトリに抽出します。
tar xvzf filename.tar.gz -C path-to-base-directory
cd
コマンドを使用して、ベース ディレクトリに移動します。-
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、
./apigeectl_1.6.9-d591b23_linux_64
となります。次のコマンドを使用して、このディレクトリの名前をapigeectl
に変更します。mv apigeectl_1.6.9-d591b23_linux_64 apigeectl
- 次のコマンドを使用して、このディレクトリに移動します。
cd ./apigeectl
このディレクトリは
apigeectl
ホーム ディレクトリになります。apigeectl
実行可能コマンドはこのディレクトリに配置されます。 version
コマンドでapigeectl
のバージョンを確認します。./apigeectl version
Version: 1.6.9
- 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
export APIGEECTL_HOME=$PWD
- 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
echo $APIGEECTL_HOME
macOS
-
次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_mac_64.tar.gz
- システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
-
次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベース ディレクトリに抽出します。
tar xvzf filename.tar.gz -C path-to-base-directory
cd
コマンドを使用して、ベース ディレクトリに移動します。-
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、
./apigeectl_1.6.9-d591b23_mac_64
となります。次のコマンドを使用して、このディレクトリの名前をapigeectl
に変更します。mv apigeectl_1.6.9-d591b23_mac_64 apigeectl
- 次のコマンドを使用して、このディレクトリに移動します。
cd ./apigeectl
このディレクトリは
apigeectl
ホーム ディレクトリになります。apigeectl
実行可能コマンドはこのディレクトリに配置されます。 version
コマンドでapigeectl
のバージョンを確認します。./apigeectl version
Version: 1.6.9
- 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
export APIGEECTL_HOME=$PWD
- 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
echo $APIGEECTL_HOME
Windows
- 次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。
curl -LO ^ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.6.9/apigeectl_windows_64.zip
- システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
-
次のコマンドを使用して、ダウンロードした .zip ファイルの内容を現在のディレクトリに抽出します。
tar xvzf filename.zip -C path-to-base-directory
cd
コマンドを使用して、ベース ディレクトリに移動します。-
デフォルトでは、tar ファイルの内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、
.\apigeectl_1.6.9-d591b23_windows_64
となります。次のコマンドを使用して、このディレクトリの名前をapigeectl
に変更します。rename apigeectl_1.6.9-d591b23_windows_64 apigeectl
- 次のコマンドを使用して、このディレクトリに移動します。
cd .\apigeectl
このディレクトリは
apigeectl
ホーム ディレクトリになります。apigeectl
実行可能コマンドはこのディレクトリに配置されます。 version
コマンドでapigeectl
のバージョンを確認します。./apigeectl version
Version: 1.6.9
- 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
set APIGEECTL_HOME=%CD%
- 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
echo %APIGEECTL_HOME%
プロジェクト ディレクトリ構造を設定する
次のディレクトリ構造は推奨案です。Apigee ハイブリッド リリース ソフトウェアは、作成する必要がある構成ファイルから分離されています。$APIGEECTL_HOME
変数とシンボリック リンクを使用すると、必要に応じて新しいソフトウェア バージョンに簡単に切り替えることができます。Apigee ハイブリッドのアップグレードもご覧ください。
Linux
- 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(
apigeectl
ディレクトリが含まれているディレクトリ)であることを確認します。cd $APIGEECTL_HOME/..
-
次のコマンドを使用して、
hybrid-files
という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントではhybrid-files
という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl
ソフトウェアのインストールとは切り離して構成ファイルを保持できます。mkdir hybrid-files
- 現在のディレクトリ構造は次のようになります。
pwd && ls
/hybrid-base-directory apigeectl hybrid-files
- 次のコマンドを使用して、ディレクトリを
hybrid-files
フォルダに変更します。cd hybrid-files
- 後で作成するファイルを整理するため、
hybrid-files
ディレクトリ内に次のサブディレクトリを作成します。mkdir overrides
mkdir certs
-
hybrid-files
ディレクトリに、$APIGEECTL_HOME
への次のシンボリック リンクを作成します。これらのリンクにより、次の例のようにhybrid-files
ディレクトリからapigeectl
コマンドを実行できます。ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins - シンボリック リンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
ls -l | grep ^l
macOS
- 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(
apigeectl
ディレクトリが含まれているディレクトリ)であることを確認します。cd $APIGEECTL_HOME/..
-
次のコマンドを使用して、
hybrid-files
という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントではhybrid-files
という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl
ソフトウェアのインストールとは切り離して構成ファイルを保持できます。mkdir hybrid-files
- 現在のディレクトリ構造は次のようになります。
pwd && ls
/hybrid-base-directory apigeectl hybrid-files
- 次のコマンドを使用して、ディレクトリを
hybrid-files
フォルダに変更します。cd hybrid-files
- 後で作成するファイルを整理するため、
hybrid-files
ディレクトリ内に次のサブディレクトリを作成します。mkdir overrides
mkdir certs
-
hybrid-files
ディレクトリに、$APIGEECTL_HOME
への次のシンボリック リンクを作成します。これらのリンクにより、次の例のようにhybrid-files
ディレクトリからapigeectl
コマンドを実行できます。ln -s
$APIGEECTL_HOME
/tools toolsln -s
$APIGEECTL_HOME
/config configln -s
$APIGEECTL_HOME
/templates templatesln -s
$APIGEECTL_HOME
/plugins plugins - シンボリック リンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
ls -l | grep ^l
Windows
- 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(
apigeectl
ディレクトリが含まれているディレクトリ)であることを確認します。cd %APIGEECTL_HOME%\..
-
次のコマンドを使用して、
hybrid-files
という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントではhybrid-files
という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl
ソフトウェアのインストールとは切り離して構成ファイルを保持できます。mkdir hybrid-files
- 現在のディレクトリ構造は次のようになります。
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.6.9rc1-437dccc_windows_64.zip 08/05/2021 01:38 PM <DIR> hybrid-files
-
ディレクトリを変更して、
hybrid-files
フォルダに移動します。 - 後で作成するファイルを整理するため、
hybrid-files
ディレクトリ内に次のサブディレクトリを作成します。mkdir overrides
mkdir certs
-
hybrid-files
ディレクトリに、$APIGEECTL_HOME
への次のシンボリック リンクを作成します。これらのリンクにより、次の例のようにhybrid-files
ディレクトリからapigeectl
コマンドを実行できます。mklink /d config %APIGEECTL_HOME%\config\
mklink /d plugins %APIGEECTL_HOME%\plugins\
mklink /d templates %APIGEECTL_HOME%\templates\
mklink /d tools %APIGEECTL_HOME%\tools\
-
シンボリック リンクが正しく作成されたことを確認するには、
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\]
これで、Kubernetes クラスタで Apigee ハイブリッドを構成、デプロイ、管理するためのホームベースが準備されました。次に、ハイブリッド ランタイム コンポーネントの構成に必要な Google Cloud サービス アカウントと認証情報を作成します。
1 2 3 4 (次)ステップ 5: サービス アカウントを設定する 6 7 8 9