For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Kubernetes クラスターに Solo Enterprise for agentregistry をインストールします。

始める前に

2. OIDC プロバイダーとして Keycloak または Microsoft Entra ID をセットアップします。次の環境変数が設定されていることを確認します。

   echo "KEYCLOAK_ISSUER: $KEYCLOAK_ISSUER"
   echo "AR_BACKEND_SECRET: $AR_BACKEND_SECRET"

   echo "OIDC_ISSUER: $OIDC_ISSUER"
   echo "AR_APP_ID: $AR_APP_ID"
   echo "AR_SCOPE: $AR_SCOPE"
   echo "AR_ADMIN_GROUP_ID: $AR_ADMIN_GROUP_ID"

3. Solo Enterprise for agentregistry のライセンスキーを環境変数に保存します。キーを取得するには、アカウント担当者にお問い合わせください。シークレットでキーを指定するなど、その他のオプションについては、ライセンスを参照してください。

   echo "KEYCLOAK_ISSUER: $KEYCLOAK_ISSUER"
   echo "AR_BACKEND_SECRET: $AR_BACKEND_SECRET"

Step 1: Install

プロバイダーの OIDC 設定を使用して Solo Enterprise for agentregistry をインストールします。

helm upgrade --install agentregistry \
  oci://us-docker.pkg.dev/solo-public/agentregistry-enterprise/helm/agentregistry-enterprise \
  --version 2026.9.0 \
  --namespace agentregistry-system \
  --create-namespace \
  --set licensing.createSecret=true \
  --set licensing.licenseKey=$AGENTREGISTRY_LICENSE_KEY \
  --set oidc.issuer=$KEYCLOAK_ISSUER \
  --set oidc.clientId=ar-backend \
  --set oidc.clientSecret=$AR_BACKEND_SECRET \
  --set oidc.publicClientId=ar-ui \
  --set oidc.roleClaim=Groups \
  --set oidc.superuserRole=admins

helm upgrade --install agentregistry \
  oci://us-docker.pkg.dev/solo-public/agentregistry-enterprise/helm/agentregistry-enterprise \
  --version 2026.9.0 \
  --namespace agentregistry-system \
  --create-namespace \
  --set licensing.createSecret=true \
  --set licensing.licenseKey=$AGENTREGISTRY_LICENSE_KEY \
  --set oidc.issuer=$OIDC_ISSUER \
  --set oidc.clientId=$AR_APP_ID \
  --set oidc.publicClientId=$AR_APP_ID \
  --set oidc.additionalScopes=$AR_SCOPE \
  --set oidc.roleClaim=groups \
  --set oidc.superuserRole=$AR_ADMIN_GROUP_ID

Step 2: Verify

Solo Enterprise for agentregistry の Pod が起動して実行中であることを確認します。

kubectl get pods -n agentregistry-system

出力例:

NAME                                                            READY   STATUS    RESTARTS   AGE
agentregistry-clickhouse-shard0-0                               1/1     Running   0          51s
agentregistry-enterprise-postgresql-764898cbff-l8477            1/1     Running   0          51s
agentregistry-enterprise-server-7d56d5b698-zxj8k                1/1     Running   0          51s
agentregistry-enterprise-telemetry-collector-6ff77cbc4f-fgzwk   1/1     Running   0          51s

レジストリにアクセスする

1. Solo Enterprise for agentregistry サーバーをポート 12121 でポートフォワードします。レジストリサービスはデフォルトでは外部に公開されないため、ローカルマシンから到達するにはポートフォワードが必要です。arctl CLI と UI はどちらも、レジストリエンドポイントとして既定で http://localhost:12121 を使用します。

   kubectl -n agentregistry-system port-forward svc/agentregistry-enterprise-server 12121:12121

2. UI にアクセスします。

   Solo Enterprise for agentregistry UI を開き、ユーザー名 admin-user、パスワード password でログインします。ダッシュボードが表示されることを確認します。

   

   

   Solo Enterprise for agentregistry UI を開き、Entra ID の認証情報でログインします。ユーザーは、レジストリへのアクセスを付与されたグループに所属している必要があります。詳細については、サインインできるユーザーを制限するを参照してください。

   ダッシュボードが表示されることを確認します。

   

   

Step 4: Install the arctl CLI

arctl CLI は、Solo Enterprise for agentregistry で AI アーティファクトを管理するための主要なツールです。AI アーティファクトの作成、公開、デプロイに使用します。arctl コマンドを実行する前に、有効なアクセストークンを取得するために、CLI を OIDC プロバイダーで認証する必要があります。

1. arctl CLI をダウンロードしてインストールします。

   curl -sSL https://storage.googleapis.com/agentregistry-enterprise/install.sh | ARCTL_VERSION=v2026.9.0 sh
   export PATH=$HOME/.arctl/bin:$PATH

2. OIDC プロバイダーに一致するフローでレジストリにログインします。

   対話型のデバイス認可フローと、CI/CD 用のユーザー名とパスワード認証情報フローのどちらかを選択します。

   ターミナルからの対話型ログインには、このフローを使用します。CLI は ar-cli-interactive パブリッククライアントを使用して、デバイス認可付与フロー を開始します。このフローでは、ブラウザーで承認するための URL とワンタイムコードが出力されます。

   1. Keycloak の発行者と ar-cli-interactive クライアントを使用するように CLI を設定します。その後、Solo Enterprise for agentregistry にログインします。

      export OIDC_ISSUER=$KEYCLOAK_ISSUER
      export OIDC_CLIENT_ID=ar-cli-interactive
      arctl user login

      出力例:

      To complete the login process, please:
       1. Open: http://172.18.0.13:8080/realms/agentregistry/device
       2. Enter the code: SYSQ-SNSP
       - or go to: http://172.18.0.13:8080/realms/agentregistry/device?user_code=SYSQ-SNSP
      

   2. Web ブラウザーで URL を開き、admin-user ユーザー名と password パスワードで Keycloak にログインします。ブラウザーでコードを確認すると、Keycloak は CLI セッション用のアクセストークンを発行します。認可が完了すると、CLI はトークンをシステムのキーチェーンに保存するため、トークンが期限切れになるまで再度ログインする必要はありません。

   CI/CD パイプラインなど、特定のユーザー ID が必要なスクリプト化されたログインには、このフローを使用します。CLI は ar-cli-password パブリッククライアントを使用し、ユーザー名とパスワードを直接アクセストークンと交換します。

   1. admin-user/password の認証情報で Solo Enterprise for agentregistry にログインします。

      export OIDC_ISSUER=$KEYCLOAK_ISSUER
      arctl user login \
        --oidc-flow=password-credentials \
        --oidc-client-id=ar-cli-password \
        --oidc-username=admin-user \
        --oidc-password=password

   2. アクセストークンを ARCTL_API_TOKEN 環境変数に保存します。

      export ARCTL_API_TOKEN=$(arctl user info --show-tokens | jq -r .access_token)

   ターミナルからの対話型ログインには、このフローを使用します。CLI は Entra アプリ登録のクライアント ID を使用し、ブラウザーで承認するための URL と 1 回限りのコードを出力する デバイス認可グラントフローを開始します。Microsoft はこのグラントタイプを推奨していないため、Entra にはユーザー名とパスワード認証情報フローに相当するものがないことに注意してください。

   1. Entra アプリ登録のクライアント ID と発行者を使用するよう CLI を設定します。Entra は要求されたスコープでトークンのオーディエンスをスコープするため、--oidc-scope フラグでアプリ所有のスコープを渡す必要があります。

      export OIDC_ISSUER=$OIDC_ISSUER
      export OIDC_CLIENT_ID=$AR_APP_ID
      arctl user login --oidc-scope "${AR_SCOPE}"

   2. Web ブラウザーで URL を開き、Entra のセットアップ時に割り当てた管理者グループのメンバーとしてサインインします。認可が完了すると、CLI はトークンをシステムキーチェーンに保存するため、有効期限が切れるまで再ログインする必要はありません。

3. 次のことを確認します you できます run arctl commands。

   arctl user whoami

   出力例:

   FIELD       VALUE
   Subject     8d7ffd9c-1f75-459a-b900-bfa4f5e3b492
   Email       admin-user@example.com
   Issuer      http://172.18.0.10:8080/realms/agentregistry
   Superuser   true (overrides role-based permission checks)
   
   ROLE     STATUS
   admins   no explicit permissions configured
   

   Note

CLI で 401 エラーが表示される場合は、以前に ARCTL_API_TOKEN 環境変数にトークンを保存している可能性があります。この環境変数は、CLI のログインフローで取得したトークンよりも優先されます。unset ARCTL_API_TOKEN を実行してから、CLI のログインフローをやり直してください。

次のステップ

AI アーティファクトの検出とデプロイを開始できるように、ランタイムを接続します。