このステップでは、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.gzLinux 64 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_64.tar.gzMac 32 ビット:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_mac_32.tar.gzLinux 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