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

このステップでは、apigeectl をダウンロードしてインストールする方法について説明します。

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

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

次の手順では、apigeectl をダウンロードしてインストールする方法について説明します。

Linux

次のコマンドを使用して、最新のバージョン番号を変数に格納します。

export VERSION=$(curl -s \
    "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
```
echo $VERSION
```
```
  1.11.2
```
次のコマンドを使用して、ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。
```
curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
```
システム上に Apigee ハイブリッドインストールのベースディレクトリとして機能するディレクトリを作成します。
次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベースディレクトリに抽出します。
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd コマンドを使用して、ベースディレクトリに移動します。
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.11.2-d591b23_linux_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。
```
mv apigeectl_1.11.2-d591b23_linux_64/ apigeectl
```
次のコマンドを使用して、このディレクトリに移動します。
```
cd ./apigeectl
```
このディレクトリは apigeectl ホームディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。
version コマンドで apigeectl のバージョンを確認します。
```
./apigeectl version
```
```
Version: 1.11.2
```
次のコマンドを使用して、このホームディレクトリパスを保持する環境変数を作成します。
```
export APIGEECTL_HOME=$PWD
```
次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
```
echo $APIGEECTL_HOME
```

macOS

次のコマンドを使用して、最新のバージョン番号を変数に格納します。

export VERSION=$(curl -s \
    "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")

次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
```
echo $VERSION
```
```
  1.11.2
```
次のコマンドを使用して、ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。
```
curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
```
システム上に Apigee ハイブリッドインストールのベースディレクトリとして機能するディレクトリを作成します。
次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベースディレクトリに抽出します。
```
tar xvzf filename.tar.gz -C path-to-base-directory
```
cd コマンドを使用して、ベースディレクトリに移動します。
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.11.2-d591b23_mac_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。
```
mv apigeectl_1.11.2-d591b23_mac_64 apigeectl
```
次のコマンドを使用して、このディレクトリに移動します。
```
cd ./apigeectl
```
このディレクトリは apigeectl ホームディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。
version コマンドで apigeectl のバージョンを確認します。
```
./apigeectl version
```
```
Version: 1.11.2
```
次のコマンドを使用して、このホームディレクトリパスを保持する環境変数を作成します。
```
export APIGEECTL_HOME=$PWD
```
次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
```
echo $APIGEECTL_HOME
```

Windows

次のコマンドを使用して、最新のバージョン番号を変数に格納します。

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
```
echo %VERSION%
```
```
  1.11.2
```
次のコマンドを使用して、ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。
```
curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip
```
システム上に Apigee ハイブリッドインストールのベースディレクトリとして機能するディレクトリを作成します。
次のコマンドを使用して、ダウンロードした .zip ファイルの内容を現在のディレクトリに抽出します。
```
tar xvzf filename.zip -C path-to-base-directory
```
cd コマンドを使用して、ベースディレクトリに移動します。
デフォルトでは、tar ファイルの内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、.\apigeectl_1.11.2-d591b23_windows_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。
```
rename apigeectl_1.11.2-d591b23_windows_64 apigeectl
```
次のコマンドを使用して、このディレクトリに移動します。
```
cd .\apigeectl
```
このディレクトリは apigeectl ホームディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。
version コマンドで apigeectl のバージョンを確認します。
```
./apigeectl version
```
```
Version: 1.11.2
```
次のコマンドを使用して、このホームディレクトリパスを保持する環境変数を作成します。
```
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 ディレクトリへのパスを保持する環境変数を作成します。
```
export HYBRID_FILES=$PWD
```
```
echo $HYBRID_FILES
```
後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
```
mkdir overrides
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
```

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 ディレクトリへのパスを保持する環境変数を作成します。
```
export HYBRID_FILES=$PWD
```
```
echo $HYBRID_FILES
```
後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
```
mkdir overrides
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
```

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.11.2rc1-437dccc_windows_64.zip
08/05/2021  01:38 PM    <DIR>          hybrid-files

ディレクトリを変更して、hybrid-files フォルダに移動します。
hybrid-files ディレクトリへのパスを保持する環境変数を作成します。
```
set HYBRID_FILES=%CD%
```
```
echo %HYBRID_FILES%
```
後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
```
mkdir overrides
mkdir certs
```
hybrid-files ディレクトリに、$APIGEECTL_HOME への次のシンボリックリンクを作成します。これらのリンクにより、次の例のように hybrid-files ディレクトリから apigeectl コマンドを実行できます。
注: mklink コマンドを実行するには、Windows コンピュータの管理者権限が必要です。これは、管理者としてコマンドターミナルを実行するか、runas コマンドを使用することで達成できます。次に例を示します。
```
runas /noprofile /user:mymachine\administrator "mklink /d config %APIGEECTL_HOME%\config"
```
```
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 10

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

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

Linux

macOS

Windows

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

Linux

macOS

Windows

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

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