ソリューション・チュートリアルの概要

ソリューション・チュートリアルでは、一般的なパターンを、IBM Cloud でベスト・プラクティスおよび実証済みのテクノロジーに基づいて実装する方法について、手順を追って説明しています。

チュートリアルのコレクションを読み進める前に、このコレクションに含まれている各ガイドの手順を正常に行えるように、本ガイドを参考にして開発環境をセットアップしてください。

目標

IBM Cloud で生産性を上げるための必須ツールをインストールします。

  • IBM Cloud CLI - IBM Cloud API と対話するためのコマンド・ライン・インターフェース。
  • Docker - コンテナーと呼ばれるパッケージでソフトウェアを配信および実行します。
  • kubectl - Kubernetes クラスターに対してコマンドを実行するためのコマンド・ライン・インターフェース。
  • oc - OpenShift アプリケーションを管理します。また、システムの各コンポーネントと対話するためのツールを提供します。
  • Helm 3 - Kubernetes アプリケーションの管理を支援します。Helm チャートは、Kubernetes アプリケーションが非常に複雑であっても、その定義、インストール、アップグレードを支援します。
  • Terraform - リソース・プロビジョニングを自動化します。
  • jq - 軽量で柔軟なコマンド・ライン JSON プロセッサー。
  • Git - 無料でオープン・ソースの分散型バージョン管理システム。

これらのツールのインストールを回避するために、 IBM Cloud コンソールから Cloud Shell を使用することもできます。

Microsoft Windows

以下のセクションでは、管理者特権を持つユーザーとして Microsoft Windows 10 64 ビット版を実行していると想定しています。 個別のセクションを実行した後に、すべてのオペレーティング・システムに共通の構成に進んでください。

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest から IBM Cloud CLI をダウンロードしてインストールします。

  2. 以下を使用して、インストールを確認してください。

    ibmcloud version

    インストール後に、マシンの再始動が必要になる場合があります。

Docker

  1. Docker Desktop on Windows は、Windows 上でコンテナー・イメージを実行するためのオプションの 1 つです。 インストールを進める前に、ご使用条件を確認してください。

  2. アカウントを持っていない場合は、https://hub.docker.com/signup で無料のアカウントを登録します。

  3. https://docs.docker.com/docker-for-windows/install/ から Docker Desktop on Windows をダウンロードして、インストールします。

  4. 以下を使用して、インストールを確認してください。

    docker --version
docker run hello-world

    ログアウトして、Docker デーモンが開始されるのを待つ必要がある場合があります。

kubectl

  1. kubectl を https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-windowsからダウンロードします。
  2. kubectl.exe バイナリーを PATH に移動します。
  3. 以下を使用して、インストールを確認してください。
    kubectl version --client=true

oc

  1. 最新の 4.x OpenShift CLI (oc) を https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/ からダウンロードします。
  2. oc.exe バイナリーを PATH に移動します。
  3. 以下を使用して、インストールを確認してください。
    oc version

Helm 3

  1. https://github.com/helm/helm/releases/latest から helm をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. helm.exe バイナリーを PATH に移動します。
  4. 以下を使用して、インストールを確認してください。
    helm version

Terraform

  1. https://developer.hashicorp.com/terraform/downloadsから terraform をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. terraform.exe バイナリーを PATH に移動します。
  4. 以下を使用して、インストールを確認してください。
    terraform version

IBM Cloud リソースを Terraform で管理するには、IBM Cloud プロバイダーもインストールする必要があります。 Terraform 0.13 以降、Terraform プラグイン・レジストリーからプロバイダーを自動的にダウンロードできるようになりました。 プロバイダーの資料の手順に従って、Terraform テンプレートの required_providers プロパティーを構成してください。

jq

  1. https://jqlang.github.io/jq/から jq をダウンロードします。
  2. jq-win64.exe を jq.exe という名前に変更します。
  3. jq.exe バイナリーを PATH に移動します。
  4. 以下を使用して、インストールを確認してください。
    jq --version

Git

  1. https://github.com/git-for-windows/git/releases/latest から git をダウンロードしてインストールします。
  2. 以下を使用して、インストールを確認してください。
    git --version

すべてのオペレーティング・システムに共通の構成に進みます。

Apple macOS

以下のセクションでは、管理者特権を持つユーザーとして macOS High Sierra 以降を実行していると想定しています。 個別のセクションを実行した後に、すべてのオペレーティング・システムに共通の構成に進んでください。

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest から IBM Cloud CLI をダウンロードしてインストールします。
  2. 以下を使用して、インストールを確認してください。
    ibmcloud version

Docker

  1. Docker Desktop on Mac は、macOS 上でコンテナー・イメージを実行するためのオプションの 1 つです。 インストールを進める前に、ご使用条件を確認してください。 その他のオプションには、Podman があります。
  2. アカウントを持っていない場合は、https://hub.docker.com/signup で無料のアカウントを登録します。
  3. https://docs.docker.com/docker-for-mac/install/ から Docker Desktop on Mac をダウンロードして、インストールします。
  4. 以下を使用して、インストールを確認してください。
    docker --version
docker run hello-world

kubectl

  1. kubectl を https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-macosからダウンロードします。
  2. kubectl バイナリーを実行可能にします。
    chmod +x ./kubectl
  3. バイナリーを PATH に移動します。
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 以下を使用して、インストールを確認してください。
    kubectl version --client=true

oc

  1. 最新の 4.x OpenShift CLI (oc) を https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/ からダウンロードします。
  2. openshift-client-mac.tar.gz (Intel) または openshift-install-mac-arm64.tar.gz (Apple 含有) を解凍します。
    tar zxvf openshift-client-mac*.tar.gz oc
  3. oc バイナリーを PATH に移動します。
    sudo mv ./oc /usr/local/bin/oc
  4. 以下を使用して、インストールを確認してください。
    oc version
    macOS Catalina 以降では、開発者を検証できないことを示すメッセージが表示される場合があります。 その場合に oc を実行できるようにするには、sudo xattr -r -d com.apple.quarantine /usr/local/bin/oc を実行します。

Helm 3

  1. https://github.com/helm/helm/releases/latest から helm をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. helm バイナリーを PATH に移動します。
    sudo mv ./darwin-amd64/helm /usr/local/bin/helm
  4. 以下を使用して、インストールを確認してください。
    helm version
    macOS Catalina 以降では、開発者を検証できないことを示すメッセージが表示される場合があります。 その場合に helm を実行できるようにするには、sudo xattr -r -d com.apple.quarantine /usr/local/bin/helm を実行します。

Terraform

  1. https://developer.hashicorp.com/terraform/downloadsから terraform をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. terraform バイナリーを PATH に移動します。
    sudo mv ./terraform /usr/local/bin/terraform
  4. 以下を使用して、インストールを確認してください。
    terraform version

IBM Cloud リソースを Terraform で管理するには、IBM Cloud プロバイダーもインストールする必要があります。 Terraform 0.13 以降、Terraform プラグイン・レジストリーからプロバイダーを自動的にダウンロードできるようになりました。 プロバイダーの資料の手順に従って、Terraform テンプレートの required_providers プロパティーを構成してください。

jq

  1. https://jqlang.github.io/jq/から jq をダウンロードします。
  2. ダウンロードしたファイルを jq という名前に変更します。
  3. jq バイナリーを実行可能にします。
    chmod +x ./jq
  4. jq バイナリーを PATH に移動します。
    sudo mv ./jq /usr/local/bin/jq
  5. 以下を使用して、インストールを確認してください。
    jq --version
    macOS Catalina 以降では、開発者を検証できないことを示すメッセージが表示される場合があります。 その場合に jq を実行できるようにするには、sudo xattr -r -d com.apple.quarantine /usr/local/bin/jq を実行します。

Git

  1. git がインストールされていることを次のように確認します。
    git --version
    macOS から、開発者ツールをインストールするよう求めるプロンプトが表示されることがあります。 これらのツールには、git コマンド・ラインが含まれます。

すべてのオペレーティング・システムに共通の構成に進みます。

Ubuntu Linux

以下のセクションでは、root 権限に対するアクセス権を持つ非 root ユーザーとして Ubuntu Linux を実行していると想定しています。 個別のセクションを実行した後に、すべてのオペレーティング・システムに共通の構成に進んでください。 Linux ベースの Cloud シェルを使用している場合は、Cloud シェルに関するセクションに進んでください。

IBM Cloud CLI

  1. https://github.com/IBM-Cloud/ibm-cloud-cli-release/releases/latest から IBM Cloud CLI をダウンロードしてインストールします。
  2. 以下を使用して、インストールを確認してください。
    ibmcloud version

Docker

  1. アカウントを持っていない場合は、https://hub.docker.com/signup で無料のアカウントを登録します。
  2. https://docs.docker.com/engine/install/ubuntu/の指示に従って、 Docker Engine を Ubuntu にインストールします。
  3. 以下を使用して、インストールを確認してください。
    docker --version
sudo docker run hello-world
    root ではなく自分のユーザーで Docker を実行するには、 インストール後 のステップを実行します。

kubectl

  1. kubectl を https://kubernetes.io/docs/tasks/tools/#install-kubectl-on-linuxからダウンロードします。
  2. kubectl バイナリーを実行可能にします。
    chmod +x ./kubectl
  3. バイナリーを PATH に移動します。
    sudo mv ./kubectl /usr/local/bin/kubectl
  4. 以下を使用して、インストールを確認してください。
    kubectl version --client=true

oc

  1. 最新の 4.x OpenShift CLI (oc) を https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/ からダウンロードします。
  2. openshift-client-linux.tar.gz を解凍します。
    tar zxvf openshift-client-linux.tar.gz oc
  3. oc バイナリーを PATH に移動します。
    sudo mv ./oc /usr/local/bin/oc
  4. 以下を使用して、インストールを確認してください。
    oc version

Helm 3

  1. https://github.com/helm/helm/releases/latest から helm をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. helm バイナリーを PATH に移動します。
    sudo mv ./linux-amd64/helm /usr/local/bin/helm
  4. 以下を使用して、インストールを確認してください。
    helm version

Terraform

  1. https://developer.hashicorp.com/terraform/downloadsから terraform をダウンロードします。
  2. ダウンロードしたアーカイブを解凍します。
  3. terraform バイナリーを PATH に移動します。
    sudo mv ./terraform /usr/local/bin/terraform
  4. 以下を使用して、インストールを確認してください。
    terraform version

IBM Cloud リソースを Terraform で管理するには、IBM Cloud プロバイダーもインストールする必要があります。 Terraform 0.13 以降、Terraform プラグイン・レジストリーからプロバイダーを自動的にダウンロードできるようになりました。 プロバイダーの資料の手順に従って、Terraform テンプレートの required_providers プロパティーを構成してください。

jq

  1. 以下を使用して、jq をインストールします。
    sudo apt install jq
  2. 以下を使用して、インストールを確認してください。
    jq --version

Git

  1. 以下を使用して、git をインストールします。
    sudo apt install git
  2. 以下を使用して、インストールを確認してください。
    git --version

すべてのオペレーティング・システムに共通の構成に進みます。

すべてのオペレーティング・システムに共通

次のセクションは、すべてのオペレーティング・システムに共通です。

IBM Cloud CLI プラグイン

プラグインは、サービス固有のコマンドを使用して IBM Cloud CLI の機能を拡張します。

  1. 以下のプラグインをインストールします。
    ibmcloud plugin install container-registry
ibmcloud plugin install cloud-object-storage
ibmcloud plugin install kubernetes-service
ibmcloud plugin install vpc-infrastructure
ibmcloud plugin install code-engine
    使用可能なすべてのプラグインを表示するには、 ibmcloud plugin repo-plugins を実行し、プラグインをインストールします。 ibmcloud plugin install <PLUGIN_NAME>

GitHub アカウント

  1. https://github.com/ で無料のアカウントを登録します。
  2. https://github.com/new で新しいパブリック・リポジトリーを作成し、GitHub に精通します。

IBM Cloud GitLab

IBM Cloud は、GitLab Community Edition に構築された、IBM Cloud にログインするのと同じ資格情報でアクセスできる、ホストされる Git リポジトリーを提供します。 Git リポジトリーとのコマンド・ライン対話を簡略化するために SSH 公開鍵を構成することをお勧めします。

  1. SSH 鍵ペアがない場合は、 この手順を使用 して、新しい SSH 鍵ペアを生成します。
  2. Git リポジトリーをホストする予定の地域 ( ダラス(us-south.git.cloud.ibm.com)、 ロンドン(eu-gb.git.cloud.ibm.com) 、 フランクフルト(eu-de.git.cloud.ibm.com)など) の Git 設定に SSH 公開鍵を追加 します。

構成を確認するには、以下のようにします。

  1. GitLab に新しいプライベート・プロジェクトを作成し、README でリポジトリーを初期化するためのオプションを選択します。
  2. SSH リンクで複製して、コマンド・ラインからプロジェクトをチェックアウトします。
  3. README ファイルを更新します。
  4. 変更内容をコミットおよびプッシュします。

Cloud Shell

oc

プリインストールされているバージョンとは別のバージョンの OpenShift CLI を使用する必要がある場合は、以下の手順に従ってください。

  1. 最新の安定した 4.x OpenShift CLI (oc) をダウンロードします。
    curl https://mirror.openshift.com/pub/openshift-v4/clients/ocp/stable/openshift-client-linux.tar.gz --output oc.tar.gz
  2. oc.tar.gz を解凍します。
    tar zxvf oc.tar.gz oc
  3. 現行ディレクトリーを PATH に追加します。
    export PATH=$PWD:$PATH
  4. 以下を使用して、インストールを確認してください。
    oc version