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

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

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

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

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

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

    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
  2. システム上に Apigee ハイブリッド インストールのベース ディレクトリとして機能するディレクトリを作成します。
  3. 次のコマンドを使用して、ダウンロードした gzip ファイルを先ほど作成したベース ディレクトリに展開します。

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

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

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

  7. 次のコマンドを使用して、このホーム ディレクトリ パスを格納する環境変数を作成します。
    export APIGEECTL_HOME=$PWD
  8. 次のコマンドを使用して、変数に正しいパスが格納されていることを確認します。
    echo $APIGEECTL_HOME

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

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

  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 ディレクトリ内に次のサブディレクトリを作成します。
    mkdir overrides
    mkdir certs
  6. 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
  7. シンボリック リンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
    ls -l | grep ^l

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

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