コンテンツにスキップ
これは最新の機能を備えた最新リリースですが、長期サポートは提供されません。サポートを継続するには、新しいリリースごとにアップグレードするか、四半期ごとの安定版リリースをご利用ください。

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

プライベートリポジトリアクセス

Page as Markdown

agentregistry がプライベートな GitHub または GitLab リポジトリからマニフェストを読み取り、ソースコードをクローンできるようにクレデンシャルを設定します。

エージェントまたは MCP サーバーをランタイムにデプロイするには、コンテナイメージを指定する必要があります。ただし、エージェントまたは MCP サーバーのソースコードと Dockerfile を保持する GitHub または GitLab リポジトリへの参照も追加できます。プラグインとスキルにはコンテナイメージのオプションがありません。代わりに、GitHub または GitLab リポジトリを主なソースとして使用します。

Git リポジトリがプライベートの場合は、レジストリがクローンできるように、Solo Enterprise for agentregistry に GitHub または GitLab の認証情報を設定できます。

ステップ 1: クレデンシャルを作成する

プライベートリポジトリにアクセスするための GitHub または GitLab クレデンシャルを作成します。必要な権限は設定するクレデンシャルのタイプによって異なります。

  1. GitHub 個人アクセストークン(PAT)を作成します。必要な権限はトークンタイプによって異なります。

    トークンタイプ必要な権限
    クラシック PATrepo スコープ
    きめ細かい PAT
    • リソースオーナー: プライベートリポジトリのオーナー。
    • リポジトリアクセス: 使用予定のリポジトリのみにスコープを設定します。
    • リポジトリ権限: Contents: Read。Metadata: Read は自動的に必要になります。
  2. PAT を環境変数に保存します。

    export PAT=<github-pat>
  1. GitLab 個人アクセストークン(PAT)を作成します。必要な権限はトークンタイプによって異なります。

    注: GitLab デプロイトークンはサポートされていません。デプロイトークンは git クローンを認証できますが、Solo Enterprise for agentregistry がマニフェストの事前取得中に使用する GitLab REST API にアクセスできません。代わりに個人アクセストークンを使用してください。

    トークンタイプ必要な権限
    クラシック PATread_repository スコープ
    きめ細かい PATCode: Download 権限。Code: Read は不十分です。
  2. PAT を環境変数に保存します。

    export PAT=<gitlab-pat>

ステップ 2: クレデンシャルを設定する

認証情報を含む Secret リソースを作成し、プライベートリポジトリを使用する Agent、MCP server、Skill、または Plugin マニフェストの credentialsRef フィールドから参照します。Secret は、それを参照するアーティファクトと同じネームスペースに存在する必要があります。

種類フィールドパス
Agent, MCPServer, Skillspec.source.repository.credentialsRef
Pluginspec.source.git.repository.credentialsRef
  1. Secret を作成します。

    arctl apply -f- <<EOF
    apiVersion: ar.dev/v1alpha1
    kind: Secret
    metadata:
      name: git-credentials
    spec:
      stringData:
        password: $PAT
    EOF
    arctl apply -f- <<EOF
    apiVersion: ar.dev/v1alpha1
    kind: Secret
    metadata:
      name: git-credentials
    spec:
      stringData:
        username: oauth2
        password: $PAT
    EOF
  2. Secret が作成されたことを確認します。レスポンスに認証情報の値は含まれず、保存されたキーのみが含まれます。

    arctl get secret git-credentials -o yaml

    出力例:

    apiVersion: ar.dev/v1alpha1
    kind: Secret
    metadata:
      name: git-credentials
    spec:
      type: Opaque
    status:
      dataKeys:
        - password
    
  3. AI アーティファクトのマニフェストで Secret を参照します。

    spec:
      source:
        repository:
          url: https://github.com/my-org/my-repo
          credentialsRef:
            name: git-credentials
    spec:
      source:
        type: git
        git:
          repository:
            url: https://github.com/my-org/my-repo
            credentialsRef:
              name: git-credentials

次のステップ