您托管代理的服务器可以通过网络访问以下资源：
- 您的JFrog Artifactory实例
- hub.docker.com，端口443，用于与Docker进行身份验证
- api.dso.docker.com，端口443，用于与Docker Scout进行数据交互
这些注册表是Docker V2注册表。不支持V1注册表。

该代理支持所有版本的JFrog Artifactory和JFrog Container Registry。

创建配置文件

您可以使用JSON文件配置代理。代理启动时，需要在/opt/artifactory-agent/data/config.json中找到配置文件。

配置文件包含以下属性

属性	描述
`agent_id`	代理的唯一标识符。
`docker.organization_name`	Docker组织的名称。
`docker.username`	Docker组织中管理员用户的用户名。
`docker.pat`	具有读写权限的管理员用户的个人访问令牌。
`artifactory.base_url`	Artifactory实例的基准URL。
`artifactory.username`	代理将使用的具有读取权限的Artifactory用户的用户名。
`artifactory.password`	Artifactory用户的密码或API令牌。
`artifactory.image_filters`	可选：要分析的仓库和镜像列表。

如果您未在artifactory.image_filters中指定任何仓库，则代理将对Artifactory实例中的所有镜像运行镜像分析。

以下代码段显示了一个示例配置

{
  "agent_id": "acme-prod-agent",
  "docker": {
    "organization_name": "acme",
    "username": "mobythewhale",
    "pat": "dckr_pat__dsaCAs_xL3kNyupAa7dwO1alwg"
  },
  "artifactory": [
    {
      "base_url": "https://acme.jfrog.io",
      "username": "acmeagent",
      "password": "hayKMvFKkFp42RAwKz2K",
      "image_filters": [
        {
          "repository": "dev-local",
          "images": ["internal/repo1", "internal/repo2"]
        },
        {
          "repository": "prod-local",
          "images": ["staging/repo1", "prod/repo1"]
        }
      ]
    }
  ]
}

创建一个配置文件，并将其保存在您计划运行代理的服务器上的某个位置。例如，/var/opt/artifactory-agent/config.json。

运行代理

以下示例显示了如何使用docker run运行Docker Scout Artifactory代理。此命令为包含前面在容器内/opt/artifactory-agent/data创建的JSON配置文件的目录创建一个绑定挂载点。确保您使用的挂载路径是包含config.json文件的目录。

重要
使用Artifactory代理镜像的v1标签。不要使用latest标签，因为这样做可能会导致重大更改。

$ docker run \
  --mount type=bind,src=/var/opt/artifactory-agent,target=/opt/artifactory-agent/data \
  docker/artifactory-agent:v1

分析现有数据

默认情况下，代理会在创建和更新镜像时检测并分析镜像。如果您想使用代理分析现有镜像，可以使用回填模式。使用--backfill-from=TIME命令行选项（其中TIME是ISO 8601格式的时间）以回填模式运行代理。如果您使用此选项，代理将分析从该时间到代理启动时当前时间之间推送的所有镜像，然后退出。

例如

$ docker run \
  --mount type=bind,src=/var/opt/artifactory-agent,target=/opt/artifactory-agent/data \
  docker/artifactory-agent:v1 --backfill-from=2022-04-10T10:00:00Z

多次运行回填时，代理不会分析其已分析的镜像。要强制重新分析，请提供--force命令行标志。

查看分析结果

您可以在Docker Scout仪表板中查看镜像分析结果。

访问Docker Scout仪表板中的镜像页面。
此页面显示您组织中启用了Docker Scout的仓库。
选择列表中的镜像。
选择标签。

选择标签后，您将进入该标签的漏洞报告。在这里，您可以选择是否要查看镜像中的所有漏洞，或特定层中引入的漏洞。您还可以按严重程度以及是否存在可修复版本来过滤漏洞。