For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.
プライベートリポジトリアクセス
agentregistry がプライベートな GitHub または GitLab リポジトリからマニフェストを読み取り、ソースコードをクローンできるようにクレデンシャルを設定します。
エージェントまたは MCP サーバーをランタイムにデプロイするには、コンテナイメージを指定する必要があります。ただし、エージェントまたは MCP サーバーのソースコードと Dockerfile を保持する GitHub または GitLab リポジトリへの参照も追加できます。プラグインとスキルにはコンテナイメージのオプションがありません。代わりに、GitHub または GitLab リポジトリを主なソースとして使用します。
Git リポジトリがプライベートの場合は、レジストリがクローンできるように、Solo Enterprise for agentregistry に GitHub または GitLab の認証情報を設定できます。
ステップ 1: クレデンシャルを作成する
プライベートリポジトリにアクセスするための GitHub または GitLab クレデンシャルを作成します。必要な権限は設定するクレデンシャルのタイプによって異なります。
GitHub 個人アクセストークン(PAT)を作成します。必要な権限はトークンタイプによって異なります。
PAT を環境変数に保存します。
export PAT=<github-pat>
GitLab 個人アクセストークン(PAT)を作成します。必要な権限はトークンタイプによって異なります。
注: GitLab デプロイトークンはサポートされていません。デプロイトークンは git クローンを認証できますが、Solo Enterprise for agentregistry がマニフェストの事前取得中に使用する GitLab REST API にアクセスできません。代わりに個人アクセストークンを使用してください。
PAT を環境変数に保存します。
export PAT=<gitlab-pat>
ステップ 2: クレデンシャルを設定する
認証情報を含む Secret リソースを作成し、プライベートリポジトリを使用する Agent、MCP server、Skill、または Plugin マニフェストの credentialsRef フィールドから参照します。Secret は、それを参照するアーティファクトと同じネームスペースに存在する必要があります。
| 種類 | フィールドパス |
|---|---|
| Agent, MCPServer, Skill | spec.source.repository.credentialsRef |
| Plugin | spec.source.git.repository.credentialsRef |
Secret を作成します。
arctl apply -f- <<EOF apiVersion: ar.dev/v1alpha1 kind: Secret metadata: name: git-credentials spec: stringData: password: $PAT EOFarctl apply -f- <<EOF apiVersion: ar.dev/v1alpha1 kind: Secret metadata: name: git-credentials spec: stringData: username: oauth2 password: $PAT EOFSecret が作成されたことを確認します。レスポンスに認証情報の値は含まれず、保存されたキーのみが含まれます。
arctl get secret git-credentials -o yaml出力例:
apiVersion: ar.dev/v1alpha1 kind: Secret metadata: name: git-credentials spec: type: Opaque status: dataKeys: - passwordAI アーティファクトのマニフェストで Secret を参照します。
spec: source: repository: url: https://github.com/my-org/my-repo credentialsRef: name: git-credentialsspec: source: type: git git: repository: url: https://github.com/my-org/my-repo credentialsRef: name: git-credentials