Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions content/ja/ninja-workshops/14-cisco-ai-pods/1-aws-setup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
---
title: AWSセットアップ
linkTitle: 1. AWSセットアップ
weight: 1
time: 10 minutes
---

## AWSでRed Hat OpenShiftサービスを有効にする

AWSアカウントにOpenShiftをデプロイするには、まず[AWSコンソール](https://us-east-1.console.aws.amazon.com/rosa/home?region=us-east-1#/)を使用してRed Hat OpenShiftサービスを有効にする必要があります。

次に、AWSアカウントをRed Hatアカウントに接続する手順に従ってください。

## EC2インスタンスのプロビジョニング

Red Hatクラスターをデプロイするために使用するEC2インスタンスをプロビジョニングしましょう。これにより、Mac OSでROSAコマンドラインインターフェースを実行する際の制限を回避できます。

このワークショップの作成時にはUbuntu 24.04 LTSを使用したt3.xlargeインスタンスタイプを使用しましたが、より小さなインスタンスタイプも使用できます。

インスタンスが起動したら、sshで接続してください。

## GitHubリポジトリのクローン

GitHubリポジトリをEC2インスタンスにクローンします:

``` bash
git clone https://github.com/splunk/observability-workshop.git

cd observability-workshop/workshop/cisco-ai-pods
```
61 changes: 61 additions & 0 deletions content/ja/ninja-workshops/14-cisco-ai-pods/10-cleanup.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,61 @@
---
title: まとめ
linkTitle: 10. まとめ
weight: 10
time: 5 minutes
---

## まとめ

このワークショップをお楽しみいただけたことを願っています。このワークショップでは、Splunk Observability CloudでCisco AI PODsを監視するために使用されるいくつかの技術をデプロイして操作するハンズオン体験を提供しました。具体的には、以下の機会がありました:

* GPUベースのワーカーノードを持つRedHat OpenShiftクラスターのデプロイ。
* NVIDIA NIM OperatorとNVIDIA GPU Operatorのデプロイ。
* NVIDIA NIMを使用してLarge Language Models (LLMs)をクラスターにデプロイ。
* Red Hat OpenShiftクラスターにOpenTelemetry Collectorをデプロイ。
* インフラストラクチャメトリクスを取り込むためにコレクターにPrometheusレシーバーを追加。
* Weaviateベクトルデータベースをクラスターにデプロイ。
* Large Language Models (LLMs)と連携するPythonサービスをOpenTelemetryで計装。
* LLMと連携するアプリケーションからOpenTelemetryがトレースでキャプチャする詳細を理解。

## クリーンアップ手順

このセクションの手順に従って、OpenShiftクラスターをアンインストールします。

以下のコマンドを実行して、クラスターID、クラスター固有のOperatorロール用のAmazon Resource Names (ARNs)、およびOIDCプロバイダーのエンドポイントURLを取得します:

``` bash
rosa describe cluster --cluster=$CLUSTER_NAME
```

以下のコマンドを使用してクラスターを削除します:

``` bash
rosa delete cluster --cluster=$CLUSTER_NAME --watch
```

クラスター固有のOperator IAMロールを削除します:

> 注意: プロンプトが表示されたら、デフォルト値をそのまま使用してください。

``` bash
rosa delete operator-roles --prefix $OPERATOR_ROLES_PREFIX
```

OIDCプロバイダーを削除します:

> 注意: プロンプトが表示されたら、デフォルト値をそのまま使用してください。

``` bash
rosa delete oidc-provider --oidc-config-id $OIDC_ID
```

ネットワークを削除します:

> 注意: 以下のコマンドを実行する前に、ネットワークの作成に使用したCloudFormationスタックの名前を追加してください

``` bash
aws cloudformation delete-stack --region $AWS_REGION --stack-name <stack name i.e. rosa-network-stack-nnnnnnnnnnn>
```

Red Hat OpenShift ServiceをAWSアカウントから完全に削除したい場合は、[OpenShiftドキュメント](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws/4/html/install_clusters/rosa-hcp-deleting-cluster)を参照してください。
140 changes: 140 additions & 0 deletions content/ja/ninja-workshops/14-cisco-ai-pods/2-openshift-prereqs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,140 @@
---
title: OpenShiftの前提条件
linkTitle: 2. OpenShiftの前提条件
weight: 2
time: 15 minutes
---

以下の手順は、AWSにOpenShiftクラスターをデプロイする前に必要です。

## Red Hatログインの作成

最初に行う必要があるのは、Red Hatのアカウントを作成することです。[こちら](https://www.redhat.com/wapps/ugc/register.html?_flowId=register-flow&_flowExecutionKey=e1s1)のフォームに記入して作成できます。

## AWS CLIのインストール

以前プロビジョニングしたEC2インスタンスにAWS CLIをインストールするには、以下のコマンドを実行します:

``` bash
curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
sudo apt install unzip
unzip awscliv2.zip
sudo ./aws/install
```

以下のコマンドを使用して、正常にインストールされたことを確認します:

``` bash
aws --version
```

以下のような結果が返されるはずです:

````
aws-cli/2.30.5 Python/3.13.7 Linux/6.14.0-1011-aws exe/x86_64.ubuntu.24
````

お好みの方法でAWSアカウントにログインしてください。ガイダンスについては[ドキュメント](https://docs.aws.amazon.com/signin/latest/userguide/command-line-sign-in.html)を参照してください。例えば、`aws configure`コマンドを実行してログインできます。

`aws ec2 describe-instances`などのコマンドを実行して、正常にログインできていることを確認してください。

次に、以下のコマンドでアカウントIDを確認します:

``` bash
aws sts get-caller-identity
```

ELB (Elastic Load Balancing)のサービスロールが存在するかどうかを確認します:

``` bash
aws iam get-role --role-name "AWSServiceRoleForElasticLoadBalancing"
```

ロールが存在しない場合は、以下のコマンドを実行して作成します:

``` bash
aws iam create-service-linked-role --aws-service-name "elasticloadbalancing.amazonaws.com"
```

## ROSA CLIのインストール

デプロイにはROSAコマンドラインインターフェース (CLI)を使用します。手順は[Red Hatドキュメント](https://docs.redhat.com/en/documentation/red_hat_openshift_service_on_aws_classic_architecture/4/html-single/install_rosa_classic_clusters/index#rosa-installing-and-configuring-the-rosa-cli_rosa-installing-cli)に基づいています。

お使いのオペレーティングシステム用のROSA CLIの最新リリースは[こちら](https://console.redhat.com/openshift/downloads)からダウンロードできます。

または、以下のコマンドを使用してCLIバイナリをEC2インスタンスに直接ダウンロードすることもできます:

````
curl -L -O https://mirror.openshift.com/pub/cgw/rosa/latest/rosa-linux.tar.gz
````

コンテンツを解凍します:

````
tar -xvzf rosa-linux.tar.gz
````

結果のファイル(`rosa`)をパスに含まれている場所に移動します。例えば:

``` bash
sudo mv rosa /usr/local/bin/rosa
```

以下のコマンドを実行してRed Hatアカウントにログインし、コマンド出力の指示に従ってください:

````
rosa login --use-device-code
````

## OpenShift CLI (oc)のインストール

以下のコマンドを使用して、OpenShift CLIバイナリをEC2インスタンスに直接ダウンロードできます:

````
curl -L -O https://mirror.openshift.com/pub/openshift-v4/x86_64/clients/ocp/stable/openshift-client-linux.tar.gz
````

コンテンツを解凍します:

````
tar -xvzf openshift-client-linux.tar.gz
````

結果のファイル(`oc`と`kubectl`)をパスに含まれている場所に移動します。例えば:

``` bash
sudo mv oc /usr/local/bin/oc
sudo mv kubectl /usr/local/bin/kubectl
```

## アカウント全体のロールとポリシーの作成

以下のコマンドを使用して、必要なアカウント全体のロールとポリシーを作成します:

``` bash
rosa create account-roles --mode auto
```

## ROSA HCP用のAWS VPCの作成

OpenShiftクラスターをデプロイするために、Hosted Control Plane (HCP)デプロイオプションを使用します。これを行うには、以下のコマンドを使用してAWSアカウントに新しいVPCを作成する必要があります:

> 注意: リージョンを環境に合わせて更新してください。

``` bash
rosa create network network-template --param Region=us-east-2 --template-dir='.'
```

> 重要: このコマンドの結果として作成されたサブネットIDをメモしておいてください。クラスターを作成する際に必要になります。また、ネットワークを削除する場合に後で必要になるCloudFormationスタック名もメモしておいてください。

> 注意: デフォルトでは、各AWSリージョンはElastic IPアドレスが5つに制限されています。「The maximum number of addresses has been reached.」というエラーが発生した場合は、AWSに連絡してこの制限の引き上げをリクエストするか、ROSA用のVPCを作成するために別のAWSリージョンを選択する必要があります。

## OpenID Connect設定の作成

Red Hat OpenShift Service on AWSクラスターを作成する前に、以下のコマンドでOpenID Connect (OIDC)設定を作成しましょう:

``` bash
rosa create oidc-config --mode=auto --yes
```

> 重要: 作成されたoidc-provider idをメモしておいてください。
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
---
title: AWSにOpenShiftクラスターをデプロイする
linkTitle: 3. AWSにOpenShiftクラスターをデプロイする
weight: 3
time: 25 minutes
---

## OpenShiftクラスターのデプロイ

ROSA CLIを使用してOpenShiftクラスターをデプロイします。

まず、いくつかの環境変数を設定する必要があります:

> 注意: EXPORTコマンドを実行する前に、サブネットIDとOIDC IDを入力してください。

``` bash
export CLUSTER_NAME=rosa-test
export AWS_REGION=us-east-2
export AWS_INSTANCE_TYPE=g5.2xlarge
export SUBNET_IDS=<comma separated list of subnet IDs from earlier rosa create network command>
export OIDC_ID=<the oidc-provider id returned from the rosa create oidc-config command>
export OPERATOR_ROLES_PREFIX=rosa-test-a6x9
```

以下のコマンドを使用して、OIDC設定用のオペレーターロールを作成します:

> 注意: プロンプトが表示されたら、デフォルト値をそのまま使用してください。

``` bash
rosa create operator-roles --hosted-cp --prefix $OPERATOR_ROLES_PREFIX --oidc-config-id $OIDC_ID
```

次に、以下のようにしてクラスターを作成できます:

``` bash
rosa create cluster \
--cluster-name $CLUSTER_NAME \
--mode auto \
--hosted-cp \
--sts \
--create-admin-user \
--operator-roles-prefix $OPERATOR_ROLES_PREFIX \
--oidc-config-id $OIDC_ID \
--subnet-ids $SUBNET_IDS \
--compute-machine-type $AWS_INSTANCE_TYPE \
--replicas 2 \
--region $AWS_REGION \
--tags "splunkit_environment_type:non-prd,splunkit_data_classification:private"
```

> `g5.2xlarge`インスタンスタイプを指定していることに注意してください。これには、このワークショップの後半で使用するNVIDIA GPUが含まれています。このインスタンスタイプは比較的高価で、執筆時点で1時間あたり約$1.21であり、2つのレプリカをリクエストしているため、クラスターの実行時間に注意してください。コストはすぐに蓄積されます。

クラスターの準備ができたかどうかを確認するには、以下を実行します:

``` bash
rosa describe cluster -c $CLUSTER_NAME
```

クラスターのインストールログを監視するには、以下を実行します:

``` bash
rosa logs install -c $CLUSTER_NAME --watch
```

## OpenShiftクラスターへの接続

以下のコマンドを使用して、oc CLIをOpenShiftクラスターに接続します:

> 注意: `rosa describe cluster -c $CLUSTER_NAME`コマンドを実行し、結果のAPI Server URLを以下のコマンドに代入してから実行してください。例えば、サーバー名は`https://api.rosa-test.aaa.bb.openshiftapps.com:443`のようになります。

``` bash
oc login <API Server URL> -u cluster-admin
```

クラスターに接続したら、ノードが起動して実行されていることを確認します:

``` bash
oc get nodes

NAME STATUS ROLES AGE VERSION
ip-10-0-1-184.us-east-2.compute.internal Ready worker 14m v1.31.11
ip-10-0-1-50.us-east-2.compute.internal Ready worker 20m v1.31.11
```
Loading