このステップでは、apigeectl をダウンロードしてインストールする方法について説明します。
apigeectl
のダウンロードとインストール
apigeectl
は、Apigee ハイブリッドを Kubernetes クラスタにインストールして管理するためのコマンドライン インターフェース(CLI)です。
次のステップでは、apigeectl
を取得する方法について説明します。
-
次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。
Mac 64 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_64.tar.gz
Linux 64 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_64.tar.gz
Mac 32 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_32.tar.gz
Linux 32 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_32.tar.gz
- システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
-
次のコマンドを使用して、ダウンロードした gzip ファイルを先ほど作成したベース ディレクトリに展開します。
tar xvzf filename.tar.gz -C path-to-base-directory
cd
コマンドを使用して、ベース ディレクトリに移動します。-
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、
./apigeectl_1.5.0-d591b23_linux_64
となります。次のコマンドを使用して、このディレクトリの名前をapigeectl
に変更します。mv apigeectl_1.5.0-d591b23_linux_64 apigeectl
- 次のコマンドを使用して、このディレクトリに移動します。
cd ./apigeectl
このディレクトリは
apigeectl
ホーム ディレクトリになります。apigeectl
実行可能コマンドはこのディレクトリに配置されます。 - 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
export APIGEECTL_HOME=$PWD
- 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
echo $APIGEECTL_HOME
プロジェクト ディレクトリ構造を設定する
次のディレクトリ構造は推奨案です。Apigee ハイブリッド リリース ソフトウェアは、作成する必要がある構成ファイルから分離されています。$APIGEECTL_HOME
変数とシンボリック リンクを使用すると、必要に応じて新しいソフトウェア バージョンに簡単に切り替えることができます。Apigee ハイブリッドのアップグレードもご覧ください。
- 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(
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
これで、Kubernetes クラスタで Apigee ハイブリッドを構成、デプロイ、管理するためのホームベースが準備されました。次に、ハイブリッド ランタイム コンポーネントの構成に必要な Google Cloud サービス アカウントと認証情報を作成します。
1 2 3 4 (次)ステップ 5: サービス アカウントを設定する 6 7 8 9