Serverless のインストール

手順

1. Web コンソールで、Operators → OperatorHub ページに移動します。
2. スクロールするか、またはこれらのキーワード Serverless を Filter by keyword ボックス に入力して OpenShift Serverless Operator を検索します。
3. Operator についての情報を確認してから、Install をクリックします。

4. Install Operator ページで以下を行います。

   1. Installation Mode は All namespaces on the cluster (default) になります。このモードは、デフォルトの openshift-serverless namespace で Operator をインストールし、クラスターのすべての namespace を監視し、Operator をこれらの namespace に対して利用可能にします。
   2. Installed Namespace は openshift-serverless です。

   3. Update Channel を選択します。

      • stable チャネルは、OpenShift Serverless Operator の最新の安定したリリースのインストールを可能にします。stable チャネルがデフォルトです。
      • 別のバージョンをインストールするには、対応する stable-x.y チャネル (たとえば、stable-1.29) を指定します。
   4. Update Channel として stable チャネルを選択します。stable チャネルは、OpenShift Serverless Operator の最新の安定したリリースのインストールを可能にします。
   5. Automatic または Manual 承認ストラテジーを選択します。
5. Install をクリックし、Operator をこの OpenShift Container Platform クラスターの選択した namespace で利用可能にします。

6. Catalog → Operator Management ページから、OpenShift Serverless Operator サブスクリプションのインストールおよびアップグレードの進捗をモニターできます。

   1. 手動 の承認ストラテジーを選択している場合、サブスクリプションのアップグレードステータスは、その Install Plan を確認し、承認するまで Upgrading のままになります。Install Plan ページでの承認後に、サブスクリプションのアップグレードステータスは Up to date に移行します。
   2. 自動 の承認ストラテジーを選択している場合、アップグレードステータスは、介入なしに Up to date に解決するはずです。

1. Catalog → Operator Management ページに切り替え、Operator Subscriptions および Install Plans タブで Status の下の失敗またはエラーの有無を確認します。
2. さらにトラブルシューティングを行うために、Workloads → Pods ページで問題を報告している openshift-serverless プロジェクト内の Pod のログを確認します。

手順

1. Namespace、OperatorGroup、および Subscription オブジェクトを含む YAML ファイルを作成して、namespace を OpenShift Serverless Operator にサブスクライブします。たとえば、次の内容でファイル serverless-subscription.yaml を作成します。

   Subscription の例

   ---
   apiVersion: v1
   kind: Namespace
   metadata:
     name: openshift-serverless
   ---
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: serverless-operators
     namespace: openshift-serverless
   spec: {}
   ---
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable 1
     name: serverless-operator 2
     source: redhat-operators 3
     sourceNamespace: openshift-marketplace 4

   1

   Operator のチャネル名。stable チャンネルを使用すると、OpenShift Serverless Operator の最新の安定したバージョンをインストールできます。別のバージョンをインストールするには、対応する stable-x.y チャネル (たとえば、stable-1.29) を指定します。

   2

   サブスクライブする Operator の名前。OpenShift Serverless Operator の場合、これは常に serverless-operator です。

   3

   Operator を提供する CatalogSource の名前。デフォルトの OperatorHub カタログソースには redhat-operators を使用します。

   4

   CatalogSource の namespace。デフォルトの OperatorHub カタログソースには openshift-marketplace を使用します。

2. Subscription オブジェクトを作成します。

   $ oc apply -f serverless-subscription.yaml

手順

1. Command Line Tools ページから Knative (kn) CLI をダウンロードします。Command Line Tools ページには、Web コンソールの右上の アイコンをクリックして、リストの Command Line Tools を選択します。

2. アーカイブを展開します。

   $ tar -xf <file>

3. kn バイナリーを PATH にあるディレクトリーに移動します。

4. PATH を確認するには、以下を実行します。

   $ echo $PATH

手順

1. Red Hat Subscription Manager に登録します。

   # subscription-manager register

2. 最新のサブスクリプションデータをプルします。

   # subscription-manager refresh

3. 登録済みのシステムにサブスクリプションを添付します。

   # subscription-manager attach --pool=<pool_id> 1

   1

   有効な OpenShift Container Platform サブスクリプションのプール ID

4. Knative (kn) CLI に必要なリポジトリーを有効にします。

   • Linux (x86_64, amd64)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-x86_64-rpms"

   • Linux on IBM zSystems および IBM® LinuxONE (s390x)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-s390x-rpms"

   • Linux on IBM Power (ppc64le)

     # subscription-manager repos --enable="openshift-serverless-1-for-rhel-8-ppc64le-rpms"

5. パッケージマネージャーを使用して、Knative (kn) CLI を RPM としてインストールします。

   yum コマンドの例

   # yum install openshift-serverless-clients

手順

1. DNF パッケージマネージャーの versionlock プラグインをインストールします。

   # dnf install 'dnf-command(versionlock)'

2. 次のコマンドを実行して、kn のバージョンをロックします。

   # dnf versionlock add --raw 'openshift-serverless-clients-1.7.*'

   このコマンドは、kn を Knative 1.7 に基づくバージョンにロックします。Knative 1.7 は、OpenShift Serverless 1.29 のリリース時にメンテナンスフェーズにありました。

手順

1. アップグレードされたパッケージが利用可能かどうかを確認します。

   # dnf search --showduplicates openshift-serverless-clients

2. kn のバージョンロックを削除します。

1. 新しいバージョンに kn をロックします。

1. 新しい利用可能なバージョンにアップグレードします。

   # dnf install --upgrade openshift-serverless-clients

手順

1. Knative (kn) CLI の tar.gz アーカイブをダウンロードします。

   • Linux (x86_64, amd64)
   • Linux on IBM zSystems および IBM® LinuxONE (s390x)
   • Linux on IBM Power (ppc64le)

   また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの kn をダウンロードすることもできます。

2. アーカイブを展開します。

   $ tar -xf <filename>

3. kn バイナリーを PATH にあるディレクトリーに移動します。

4. PATH を確認するには、以下を実行します。

   $ echo $PATH

手順

1. Knative (kn) CLItar.gz アーカイブ をダウンロードします。

   また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの kn をダウンロードすることもできます。

2. アーカイブを解凍して解凍します。
3. kn バイナリーを PATH にあるディレクトリーに移動します。

4. PATH を確認するには、ターミナルウィンドウを開き、以下を実行します。

   $ echo $PATH

手順

1. Knative (kn) CLIZIP アーカイブ をダウンロードします。

   また、サーバーレスクライアントダウンロードミラー 内のそのバージョンに対応するディレクトリーに移動して、任意のバージョンの kn をダウンロードすることもできます。

2. ZIP プログラムでアーカイブを展開します。
3. kn バイナリーを PATH にあるディレクトリーに移動します。

4. PATH を確認するには、コマンドプロンプトを開いて以下のコマンドを実行します。

   C:\> path

手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動します。
2. ページ上部の Project ドロップダウンメニューが Project: knative-serving に設定されていることを確認します。
3. OpenShift Serverless Operator の Provided API 一覧で Knative Serving をクリックし、Knative Serving タブに移動します。
4. Create Knative Serving をクリックします。

5. Create Knative Serving ページで、Create をクリックしてデフォルト設定を使用し、Knative Serving をインストールできます。

   また、Knative Serving インストールの設定を変更するには、提供されるフォームを使用するか、YAML を編集して KnativeServing オブジェクトを編集します。

   • KnativeServing オブジェクト作成を完全に制御する必要がない単純な設定には、このフォームの使用が推奨されます。

   • KnativeServing オブジェクトの作成を完全に制御する必要のあるより複雑な設定には、YAML の編集が推奨されます。YAML にアクセスするには、Create Knative Serving ページの右上にある edit YAML リンクをクリックします。

     フォームを完了するか、YAML の変更が完了したら、Create をクリックします。

     注記

     KnativeServing カスタムリソース定義の設定オプションの詳細は、高度なインストール設定オプション に関するドキュメントを参照してください。

6. Knative Serving のインストール後に、KnativeServing オブジェクトが作成され、Knative Serving タブに自動的にダイレクトされます。リソースの一覧に knative-serving カスタムリソースが表示されます。

検証

1. Knative Serving タブで knative-serving カスタムリソースをクリックします。

2. Knative Serving Overview ページに自動的にダイレクトされます。

   
3. スクロールダウンして、Conditions のリストを確認します。

4. ステータスが True の条件のリストが表示されます (例のイメージを参照)。

   
   注記

   Knative Serving リソースが作成されるまでに数分の時間がかかる場合があります。Resources タブでステータスを確認できます。

5. 条件のステータスが Unknown または False である場合は、しばらく待ってから、リソースが作成されたことを再度確認します。

手順

1. serving.yaml という名前のファイルを作成し、以下の YAML サンプルをこれにコピーします。

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeServing
   metadata:
       name: knative-serving
       namespace: knative-serving

2. serving.yaml ファイルを適用します。

   $ oc apply -f serving.yaml

検証

1. インストールが完了したことを確認するには、以下のコマンドを実行します。

   $ oc get knativeserving.operator.knative.dev/knative-serving -n knative-serving --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   出力例

   DependenciesInstalled=True
   DeploymentsAvailable=True
   InstallSucceeded=True
   Ready=True

   注記

   Knative Serving リソースが作成されるまでに数分の時間がかかる場合があります。

   条件のステータスが Unknown または False である場合は、しばらく待ってから、リソースが作成されたことを再度確認します。

2. Knative Serving リソースが作成されていることを確認します。

   $ oc get pods -n knative-serving

   出力例

   NAME                                                        READY   STATUS      RESTARTS   AGE
   activator-67ddf8c9d7-p7rm5                                  2/2     Running     0          4m
   activator-67ddf8c9d7-q84fz                                  2/2     Running     0          4m
   autoscaler-5d87bc6dbf-6nqc6                                 2/2     Running     0          3m59s
   autoscaler-5d87bc6dbf-h64rl                                 2/2     Running     0          3m59s
   autoscaler-hpa-77f85f5cc4-lrts7                             2/2     Running     0          3m57s
   autoscaler-hpa-77f85f5cc4-zx7hl                             2/2     Running     0          3m56s
   controller-5cfc7cb8db-nlccl                                 2/2     Running     0          3m50s
   controller-5cfc7cb8db-rmv7r                                 2/2     Running     0          3m18s
   domain-mapping-86d84bb6b4-r746m                             2/2     Running     0          3m58s
   domain-mapping-86d84bb6b4-v7nh8                             2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-bkcnj                      2/2     Running     0          3m58s
   domainmapping-webhook-769d679d45-fff68                      2/2     Running     0          3m58s
   storage-version-migration-serving-serving-0.26.0--1-6qlkb   0/1     Completed   0          3m56s
   webhook-5fb774f8d8-6bqrt                                    2/2     Running     0          3m57s
   webhook-5fb774f8d8-b8lt5                                    2/2     Running     0          3m57s

3. 必要なネットワークコンポーネントが、自動的に作成された knative-serving-ingress namespace にインストールされていることを確認します。

   $ oc get pods -n knative-serving-ingress

   出力例

   NAME                                      READY   STATUS    RESTARTS   AGE
   net-kourier-controller-7d4b6c5d95-62mkf   1/1     Running   0          76s
   net-kourier-controller-7d4b6c5d95-qmgm2   1/1     Running   0          76s
   3scale-kourier-gateway-6688b49568-987qz   1/1     Running   0          75s
   3scale-kourier-gateway-6688b49568-b5tnp   1/1     Running   0          75s

手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動します。
2. ページ上部の Project ドロップダウンメニューが Project: knative-eventing に設定されていることを確認します。
3. OpenShift Serverless Operator の Provided API 一覧で Knative Eventing をクリックし、Knative Eventing タブに移動します。
4. Create Knative Eventing をクリックします。

5. Create Knative Eventing ページでは、提供されたフォームを使用するか、YAML ファイルを編集して、KnativeEventing オブジェクトを設定できます。

   • KnativeEventing オブジェクトの作成を完全に制御する必要がない、より単純な設定には、このフォームを使用します。

6. Create をクリックします。

   • KnativeEventing オブジェクトの作成を完全に制御する必要がある、より複雑な設定の場合は、YAML ファイルを編集します。YAML エディターにアクセスするには、Create Knative Eventing ページで YAML の編集 をクリックします。
7. Knative Eventing のインストール後に、KnativeEventing オブジェクトが作成され、Knative Eventing タブに自動的にダイレクトされます。リソースの一覧に knative-eventing リソースが表示されます。

検証

1. Knative Eventing タブで knative-eventing カスタムリソースをクリックします。

2. Knative Eventing Overview ページに自動的にダイレクトされます。

   
3. スクロールダウンして、Conditions のリストを確認します。

4. ステータスが True の条件のリストが表示されます (例のイメージを参照)。

   
   注記

   Knative Eventing リソースが作成されるまでに数秒の時間がかかる場合があります。Resources タブでステータスを確認できます。

5. 条件のステータスが Unknown または False である場合は、しばらく待ってから、リソースが作成されたことを再度確認します。

手順

1. eventing.yaml という名前のファイルを作成します。

2. 以下のサンプル YAML を eventing.yaml にコピーします。

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing

3. オプション: Knative Eventing デプロイメントについて実装する必要のある変更を YAML に加えます。

4. 以下を入力して eventing.yaml ファイルを適用します。

   $ oc apply -f eventing.yaml

検証

1. 以下のコマンドを入力して出力を確認し、インストールが完了したことを確認します。

   $ oc get knativeeventing.operator.knative.dev/knative-eventing \
     -n knative-eventing \
     --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   出力例

   InstallSucceeded=True
   Ready=True

   注記

   Knative Eventing リソースが作成されるまでに数秒の時間がかかる場合があります。

2. 条件のステータスが Unknown または False である場合は、しばらく待ってから、リソースが作成されたことを再度確認します。

3. 以下のコマンドを実行して Knative Eventing リソースが作成されていることを確認します。

   $ oc get pods -n knative-eventing

   出力例

   NAME                                   READY   STATUS    RESTARTS   AGE
   broker-controller-58765d9d49-g9zp6     1/1     Running   0          7m21s
   eventing-controller-65fdd66b54-jw7bh   1/1     Running   0          7m31s
   eventing-webhook-57fd74b5bd-kvhlz      1/1     Running   0          7m31s
   imc-controller-5b75d458fc-ptvm2        1/1     Running   0          7m19s
   imc-dispatcher-64f6d5fccb-kkc4c        1/1     Running   0          7m18s

検証

1. Knative Kafka タブで knative-kafka リソースをクリックします。Knative Kafka Overview ページに自動的にダイレクトされます。

2. リソースの Conditions (状態) のリストを表示し、それらのステータスが True であることを確認します。

   

   状態のステータスが Unknown または False である場合は、ページを更新するためにしばらく待機します。

3. Apache Kafka リソースの Knative ブローカーが作成されたことを確認します。

   $ oc get pods -n knative-eventing

   出力例

   NAME                                        READY   STATUS    RESTARTS   AGE
   kafka-broker-dispatcher-7769fbbcbb-xgffn    2/2     Running   0          44s
   kafka-broker-receiver-5fb56f7656-fhq8d      2/2     Running   0          44s
   kafka-channel-dispatcher-84fd6cb7f9-k2tjv   2/2     Running   0          44s
   kafka-channel-receiver-9b7f795d5-c76xr      2/2     Running   0          44s
   kafka-controller-6f95659bf6-trd6r           2/2     Running   0          44s
   kafka-source-dispatcher-6bf98bdfff-8bcsn    2/2     Running   0          44s
   kafka-webhook-eventing-68dc95d54b-825xs     2/2     Running   0          44s

手順

1. ${XDG_RUNTIME_DIR}/podman/podman.sock で、UNIX ソケットで Docker API を提供する Podman サービスを起動します。

   $ systemctl start --user podman.socket

   注記

   多くのシステムでは、このソケットは /run/user/$(id -u)/podman/podman.sock にあります。

2. 関数のビルドに使用する環境変数を確立します。

   $ export DOCKER_HOST="unix://${XDG_RUNTIME_DIR}/podman/podman.sock"

3. -v フラグを指定して、関数プロジェクトディレクトリー内で build コマンドを実行し、詳細な出力を表示します。ローカルの UNIX ソケットへの接続が表示されるはずです。

   $ kn func build -v

手順

1. Podman マシンを作成します。

   $ podman machine init --memory=8192 --cpus=2 --disk-size=20

2. UNIX ソケットで Docker API を提供する Podman マシンを開始します。

   $ podman machine start
   Starting machine "podman-machine-default"
   Waiting for VM ...
   Mounting volume... /Users/myuser:/Users/user
   
   [...truncated output...]
   
   You can still connect Docker API clients by setting DOCKER_HOST using the
   following command in your terminal session:
   
   	export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'
   
   Machine "podman-machine-default" started successfully

   注記

   ほとんどの macOS システムでは、このソケットは /Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock にあります。

3. 関数のビルドに使用する環境変数を確立します。

   $ export DOCKER_HOST='unix:///Users/myuser/.local/share/containers/podman/machine/podman-machine-default/podman.sock'

4. -v フラグを指定して、関数プロジェクトディレクトリー内で build コマンドを実行し、詳細な出力を表示します。ローカルの UNIX ソケットへの接続が表示されるはずです。

   $ kn func build -v

手順

1. 最初に OpenShift Serverless リリースノートを検索してインストールされた OpenShift Serverless Operator のバージョンを特定します。

   たとえば、アップグレードの試行時のエラーメッセージには以下の文字列が含まれる場合があります。

   The installed KnativeServing version is v1.5.0.

   この例では、KnativeServing MAJOR.MINOR バージョンは 1.5 です。これは、OpenShift Serverless 1.26 のリリースノートで説明しています。OpenShift Serverless は Knative Serving 1.5 を使用するようになりました。

2. OpenShift Serverless Operator とそのすべてのインストール計画をアンインストールします。

3. 最初の手順で検出された OpenShift Serverless Operator のバージョンを手動でインストールします。インストールするには、以下の例のように serverless-subscription.yaml ファイルを作成します。

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: serverless-operator
     namespace: openshift-serverless
   spec:
     channel: stable
     name: serverless-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Manual
     startingCSV: serverless-operator.v1.26.0

4. 次に、以下のコマンドを実行してサブスクリプションをインストールします。

   $ oc apply -f serverless-subscription.yaml

5. アップグレードインストールプランが表示される際に手動で承認してアップグレードします。