ステップ 4: apigeectl をインストールする

このステップでは、apigeectl をダウンロードしてインストールし、インストールディレクトリを設定して、Google Cloud サービスアカウントと Apigee ハイブリッドの動作に必要な TLS 認証情報を作成する方法を説明します。

`apigeectl` のダウンロードとインストール

apigeectl は、Apigee ハイブリッドを Kubernetes クラスタにインストールして管理するためのコマンドラインインターフェース（CLI）です。

次のステップでは、apigeectl を取得する方法について説明します。

次のコマンドを使用して、最新のバージョン番号を変数に格納します。
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
```
注: 一部の MacOS ターミナルシェルでは、このコマンドからエラーが返される場合があります。エラーが表示された場合は、次のように、?ignoreCache=1 を付けずに実行してみてください。
```
export VERSION=$(curl -s \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)
```
次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
```
echo $VERSION
```
```
  1.4.0
```

次のコマンドを使用して、ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。

Mac 64 ビット:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

Linux 64 ビット:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

Mac 32 ビット:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz

Linux 32 ビット:

curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz

システム上に Apigee ハイブリッドインストールのベースディレクトリとして機能するディレクトリを作成します。
次のコマンドを使用して、ダウンロードした gzip ファイルを先ほど作成したベースディレクトリに展開します。
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd コマンドを使用して、ベースディレクトリに移動します。
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.4.0-d591b23_linux_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。
```
mv apigeectl_1.4.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 service-accounts
mkdir certs
```
hybrid-files ディレクトリに、$APIGEECTL_HOME への次のシンボリックリンクを作成します。これらのリンクにより、次の例のように hybrid-files ディレクトリから apigeectl コマンドを実行できます。
注: このプロセスを使用するのが初めてではない場合は、次のシンボリックリンクがすでに存在する可能性があります。次のコマンドを使用して、リンクがすでに存在するかどうかを確認してください。ディレクトリが存在する場合は、このステップをスキップします。
```
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
```
シンボリックリンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
```
ls -l | grep ^l
```

これで、Kubernetes クラスタで Apigee ハイブリッドを構成、デプロイ、管理するためのホームベースが準備されました。次に、ハイブリッドランタイムコンポーネントの構成に必要な Google Cloud サービスアカウントと認証情報を作成します。

1 2 3 4 （次）ステップ 5: サービスアカウントを設定する 6 7

ステップ 4: apigeectl をインストールする コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

apigeectl のダウンロードとインストール

プロジェクト ディレクトリ構造を設定する

ステップ 4: apigeectl をインストールする

`apigeectl` のダウンロードとインストール

プロジェクトディレクトリ構造を設定する