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

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

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

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

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

Linux

  1. 次のコマンドを使用して、最新のバージョン番号を変数に格納します。
    export VERSION=$(curl -s \
        "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")
  2. 次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
    echo $VERSION
      1.11.2
  3. 次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
  4. システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
  5. 次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベース ディレクトリに抽出します。

    tar xvzf filename.tar.gz -C path-to-base-directory
  6. cd コマンドを使用して、ベース ディレクトリに移動します。
  7. デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.11.2-d591b23_linux_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。

    mv apigeectl_1.11.2-d591b23_linux_64/ apigeectl
  8. 次のコマンドを使用して、このディレクトリに移動します。
    cd ./apigeectl

    このディレクトリは apigeectl ホーム ディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。

  9. version コマンドで apigeectl のバージョンを確認します。
    ./apigeectl version
    Version: 1.11.2
  10. 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
    export APIGEECTL_HOME=$PWD
  11. 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
    echo $APIGEECTL_HOME

macOS

  1. 次のコマンドを使用して、最新のバージョン番号を変数に格納します。
    export VERSION=$(curl -s \
        "https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1")
  2. 次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
    echo $VERSION
      1.11.2
  3. 次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。

    curl -LO \
        https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
  4. システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
  5. 次のコマンドを使用して、ダウンロードした gzip ファイルの内容を先ほど作成したベース ディレクトリに抽出します。

    tar xvzf filename.tar.gz -C path-to-base-directory
  6. cd コマンドを使用して、ベース ディレクトリに移動します。
  7. デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.11.2-d591b23_mac_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。

    mv apigeectl_1.11.2-d591b23_mac_64 apigeectl
  8. 次のコマンドを使用して、このディレクトリに移動します。
    cd ./apigeectl

    このディレクトリは apigeectl ホーム ディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。

  9. version コマンドで apigeectl のバージョンを確認します。
    ./apigeectl version
    Version: 1.11.2
  10. 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
    export APIGEECTL_HOME=$PWD
  11. 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
    echo $APIGEECTL_HOME

Windows

  1. 次のコマンドを使用して、最新のバージョン番号を変数に格納します。
    for /f "tokens=*" %a in ('curl -s ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
    do set VERSION=%a
  2. 次のコマンドを使用して、変数にバージョン番号が挿入されていることを確認します。別のバージョンを使用する場合は、そのバージョンを環境変数に格納してください。
    echo %VERSION%
      1.11.2
  3. 次のコマンドを使用して、ご使用のオペレーティング システムに対応したリリース パッケージをダウンロードします。

    curl -LO ^
      https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip
  4. システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
  5. 次のコマンドを使用して、ダウンロードした .zip ファイルの内容を現在のディレクトリに抽出します。

    tar xvzf filename.zip -C path-to-base-directory
  6. cd コマンドを使用して、ベース ディレクトリに移動します。
  7. デフォルトでは、tar ファイルの内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、.\apigeectl_1.11.2-d591b23_windows_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。

    rename apigeectl_1.11.2-d591b23_windows_64 apigeectl
  8. 次のコマンドを使用して、このディレクトリに移動します。
    cd .\apigeectl

    このディレクトリは apigeectl ホーム ディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。

  9. version コマンドで apigeectl のバージョンを確認します。
    ./apigeectl version
    Version: 1.11.2
  10. 次のコマンドを使用して、このホーム ディレクトリ パスを保持する環境変数を作成します。
    set APIGEECTL_HOME=%CD%
  11. 次のコマンドを使用して、変数が正しいパスを保持していることを確認します。
    echo %APIGEECTL_HOME%

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

次のディレクトリ構造は推奨案です。Apigee ハイブリッド リリース ソフトウェアは、作成する必要がある構成ファイルから分離されています。$APIGEECTL_HOME 変数とシンボリック リンクを使用すると、必要に応じて新しいソフトウェア バージョンに簡単に切り替えることができます。Apigee ハイブリッドのアップグレードもご覧ください。

Linux

  1. 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(apigeectl ディレクトリが含まれているディレクトリ)であることを確認します。
    cd $APIGEECTL_HOME/..
  2. 次のコマンドを使用して、hybrid-files という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントでは hybrid-files という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl ソフトウェアのインストールとは切り離して構成ファイルを保持できます。
    mkdir hybrid-files
  3. 現在のディレクトリ構造は次のようになります。
    pwd && ls
    /hybrid-base-directory
      apigeectl
      hybrid-files
  4. 次のコマンドを使用して、ディレクトリを hybrid-files フォルダに変更します。
    cd hybrid-files
  5. hybrid-files ディレクトリへのパスを保持する環境変数を作成します。
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. 後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
    mkdir overrides
    mkdir certs
  7. hybrid-files ディレクトリに、$APIGEECTL_HOME への次のシンボリック リンクを作成します。これらのリンクにより、次の例のように hybrid-files ディレクトリから apigeectl コマンドを実行できます。
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  8. シンボリック リンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
    ls -l | grep ^l

macOS

  1. 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(apigeectl ディレクトリが含まれているディレクトリ)であることを確認します。
    cd $APIGEECTL_HOME/..
  2. 次のコマンドを使用して、hybrid-files という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントでは hybrid-files という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl ソフトウェアのインストールとは切り離して構成ファイルを保持できます。
    mkdir hybrid-files
  3. 現在のディレクトリ構造は次のようになります。
    pwd && ls
    /hybrid-base-directory
      apigeectl
      hybrid-files
  4. 次のコマンドを使用して、ディレクトリを hybrid-files フォルダに変更します。
    cd hybrid-files
  5. hybrid-files ディレクトリへのパスを保持する環境変数を作成します。
    export HYBRID_FILES=$PWD
    echo $HYBRID_FILES
  6. 後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
    mkdir overrides
    mkdir certs
  7. hybrid-files ディレクトリに、$APIGEECTL_HOME への次のシンボリック リンクを作成します。これらのリンクにより、次の例のように hybrid-files ディレクトリから apigeectl コマンドを実行できます。
    ln -s $APIGEECTL_HOME/tools tools
    ln -s $APIGEECTL_HOME/config config
    ln -s $APIGEECTL_HOME/templates templates
    ln -s $APIGEECTL_HOME/plugins plugins
  8. シンボリック リンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
    ls -l | grep ^l

Windows

  1. 次のコマンドを使用して、現在のディレクトリがベース ディレクトリ(apigeectl ディレクトリが含まれているディレクトリ)であることを確認します。
    cd %APIGEECTL_HOME%\..
  2. 次のコマンドを使用して、hybrid-files という新しいフォルダを作成します。ディレクトリには任意の名前を付けることができますが、このドキュメントでは hybrid-files という名前が一貫して使用されています。後で、このフォルダに構成ファイル、サービス アカウント キー、TLS 証明書を保存します。このフォルダには、apigeectl ソフトウェアのインストールとは切り離して構成ファイルを保持できます。
    mkdir hybrid-files
  3. 現在のディレクトリ構造は次のようになります。
    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
  4. ディレクトリを変更して、hybrid-files フォルダに移動します。
  5. hybrid-files ディレクトリへのパスを保持する環境変数を作成します。
    set HYBRID_FILES=%CD%
    echo %HYBRID_FILES%
  6. 後で作成するファイルを整理するため、hybrid-files ディレクトリ内に次のサブディレクトリを作成します。
    mkdir overrides
    mkdir certs
  7. 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\
  8. シンボリック リンクが正しく作成されたことを確認するには、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