Harbor 引入了系统级机器人账户的概念。管理员可以创建一个覆盖多个项目的系统级机器人账户。系统机器人账户用于创建非用户范围的凭据，以执行跨多个项目的操作和 API 调用。

每个系统机器人账户可以拥有多个系统权限和跨多个项目的项目级别权限。

权限参考包含权限及其操作的列表。这些权限可以组合并分配给系统机器人账户，使其能够通过 OCI 客户端或 Harbor API 执行所需的任务。机器人账户不能用于登录用户界面。

您还可以创建项目范围的机器人账户，这些账户的访问权限仅限于单个项目。阅读更多关于项目机器人账户的信息。

查看系统机器人账户

1. 以管理员身份登录到您的 Harbor 实例。
2. 在侧边栏中，选择管理部分中的 机器人账户。

此页面包含 Harbor 实例中所有现有系统机器人账户的列表。该表包含每个系统机器人账户的以下信息

• 系统账户的名称。这源自为您的 Harbor 实例配置的机器人账户前缀和创建账户时分配的名称。机器人账户名称遵循格式 <prefix><account_name>。如果您在此页面上使用搜索功能，则只需搜索不带前缀的账户名称。

• 启用状态指示账户是激活还是停用。

• 账户被分配的系统权限计数。要查看分配的系统权限的完整集合，请单击 权限 链接。

  

  

• 账户关联的项目数量。单击 项目 链接以查看与账户关联的项目的完整列表。

  

  

• 创建时间显示机器人账户的创建时间。

• 账户过期时间。根据创建时间和创建机器人账户时设置的过期时间计算得出。

• 手动为系统机器人账户添加的描述。

添加系统机器人账户

1. 使用系统管理员权限登录到 Harbor 界面。

2. 转到 管理，选择一个项目，然后选择 机器人账户。

3. 单击 新建机器人账户。

   

   

4. 输入此机器人账户的名称和可选描述。

5. 为此机器人账户设置过期时间。默认情况下，使用系统配置的过期时间。如果您想创建永不过期的机器人账户，也可以从下拉列表中选择 永不过期 。

6. 为此机器人账户选择系统权限。

7. 如果您想在所有项目中使用此系统机器人账户，请选择 覆盖所有项目 。使用此选项意味着此系统机器人账户将能够访问 Harbor 实例中的所有现有和未来项目。您可以选择要授予机器人账户的权限。
   

   

   

8. 如果您希望此机器人账户仅覆盖某些项目或被授予某些权限，请使用项目表选择要分配给系统机器人账户的项目和权限。此表显示每个项目名称、项目创建时间和用于为该项目分配系统机器人账户权限的下拉列表。

   

   

   单击项目名称旁边的复选框以关联此机器人账户。

   默认情况下，该表显示 Harbor 实例中的所有项目。您可以使用 项目名称 标题右侧的 筛选图标 来筛选项目。请注意，项目表可能会分为多个页面，并且一次只显示一部分项目，具体取决于您的 Harbor 实例中有多少项目以及有多少项目符合您的筛选条件。

   

   

   使用 权限 下拉列表选择要分配给特定项目的权限。您可以控制按项目分配给单个机器人账户的权限，从而对每个机器人账户进行细粒度控制。您可以选择 全选 或 取消全选 以快速添加或删除机器人账户的所有权限。

   推送仓库 权限必须与 拉取仓库 权限一起分配。您不能单独分配推送仓库权限。

   

   

   单击 重置所有项目权限 下拉列表以控制每个项目的可用权限。选择或取消选择权限将为每个项目添加或删除该权限。使用此选项将调整所有项目的权限，而不仅仅是如果您已筛选特定项目名称时显示的项目。

   

   

   单击 选择所有项目 以将系统机器人账户与表中显示的所有项目关联。如果您按项目名称筛选，则此选项将仅选择筛选后的项目。

9. 单击 完成。

10. 在确认窗口中，单击 导出到文件 以下载密钥作为 JSON 文件，或单击剪贴板图标将其内容复制到剪贴板。

    

    

    Harbor 不存储机器人账户密钥，因此您必须下载密钥或将内容复制并粘贴到文本文件中。创建机器人账户后，无法从 Harbor 获取密钥。

    新的机器人账户在机器人账户列表中显示为 <prefix>account_name。阅读更多关于 机器人账户前缀 的信息。

管理系统机器人账户

您可以编辑、停用或删除系统机器人账户。

1. 从管理员 机器人账户 页面，选中要更新的机器人账户旁边的复选框。
2. 选择 操作，然后选择 编辑、停用 或 删除。

刷新系统机器人账户密钥

您可以在创建机器人账户后刷新其密钥，以防您需要新的密钥。

1. 从管理员 机器人账户 页面，选中要更新的机器人账户旁边的复选框。

2. 选择 操作，然后选择 刷新密钥。

3. 默认情况下，Harbor 将随机生成一个新密钥，或者您可以选择启用手动重置密钥并输入 新密钥，然后输入 确认密钥。或者，您可以通过单击眼睛图标查看密钥。

   

   

4. 单击 刷新。如果您随机创建了密钥，请下载密钥 JSON 文件或复制并粘贴其内容。

配置机器人账户的过期期限

默认情况下，机器人账户在 30 天后过期。您可以通过修改机器人账户令牌的过期期限来为机器人账户设置更长或更短的寿命。过期期限适用于所有项目中的所有机器人账户。

1. 使用具有 Harbor 系统管理员权限的账户登录到 Harbor 界面。

2. 转到 配置 并选择 系统设置。

3. 在 机器人令牌过期（天） 行中，修改机器人账户令牌过期后的天数。

   

   

配置机器人账户前缀

默认情况下，机器人账户名称使用 robot$ 前缀。Harbor 使用此前缀来区分机器人账户和用户账户。系统机器人账户的全名是前缀和您在创建机器人账户时提供的名称。例如，如果您创建一个名为 test 的新机器人系统账户，则全名为 robot$test。

相同的前缀用于所有机器人账户，包括系统和项目机器人账户。当您更新此值时，它将应用于所有现有和未来的系统和项目机器人账户，但 Harbor v2.1 及更早版本中创建的机器人账户将继续使用前缀 robot$。

1. 使用具有 Harbor 系统管理员权限的账户登录到 Harbor 界面。

2. 转到 配置 并选择 系统设置。

3. 在 机器人名称前缀 行中，修改前缀。

   

   

使用系统机器人账户进行身份验证

要在自动化流程（例如脚本）中使用机器人账户，请使用 docker login 并提供机器人账户的凭据。

docker login <harbor_address>
Username: <prefix><account_name>
Password: <secret>

权限参考

下表解释了机器人账户在具有指定权限时可以执行的操作。

系统权限

项目权限