Chapter 21. Using the v2 UI

Procedure

1. Click Organization in the navigation pane.
2. Click Create Organization.
3. Enter an Organization Name, for example, testorg.
4. Click Create.

Procedure

1. On the Organizations page, select the name of the organization you want to delete, for example, testorg.
2. Click the More Actions drop down menu.

3. Click Delete.

   Note

   On the Delete page, there is a Search input box. With this box, users can search for specific organizations to ensure that they are properly scheduled for deletion. For example, if a user is deleting 10 organizations and they want to ensure that a specific organization was deleted, they can use the Search input box to confirm said organization is marked for deletion.

4. Confirm that you want to permanently delete the organization by typing confirm in the box.

5. Click Delete.

   After deletion, you are returned to the Organizations page.

   Note

   You can delete more than one organization at a time by selecting multiple organizations, and then clicking More Actions Delete.

Procedure

1. Click Repositories on the navigation pane.
2. Click Create Repository.

3. Select a namespace, for example, quayadmin, and then enter a Repository name, for example, testrepo.

   Important

   Do not use the following words in your repository name: * build * trigger * tag

   When these words are used for repository names, users are unable access the repository, and are unable to permanently delete the repository. Attempting to delete these repositories returns the following error: Failed to delete repository <repository_name>, HTTP404 - Not Found.

4. Click Create.

   Now, your example repository should populate under the Repositories page.

Procedure

1. On the Repositories page of the v2 UI, click the name of the image you want to delete, for example, quay/admin/busybox.
2. Click the More Actions drop-down menu.

3. Click Delete.

   Note

   If desired, you could click Make Public or Make Private.

4. Type confirm in the box, and then click Delete.
5. After deletion, you are returned to the Repositories page.

Procedure

1. Pull a sample image from an external registry:

   $ podman pull busybox

2. Tag the image:

   $ podman tag docker.io/library/busybox quay-server.example.com/quayadmin/busybox:test

3. Push the image to your registry:

   $ podman push quay-server.example.com/quayadmin/busybox:test

4. Navigate to the Repositories page on the v2 UI and ensure that your image has been properly pushed.
5. You can check the security details by selecting your image tag, and then navigating to the Security Report page.

Procedure

1. On the Repositories page of the v2 UI, click the name of the image you want to delete, for example, quay/admin/busybox.
2. Click the More Actions drop-down menu.

3. Click Delete.

   Note

   If desired, you could click Make Public or Make Private.

4. Type confirm in the box, and then click Delete.
5. After deletion, you are returned to the Repositories page.

Procedure

1. On the Red Hat Quay v2 UI, click the name of an organization.
2. On your organization’s page, click Teams and membership.
3. Click the Create new team box.
4. In the Create team popup window, provide a name for your new team.
5. Optional. Provide a description for your new team.
6. Click Proceed. A new popup window appears.
7. Optional. Add this team to a repository, and set the permissions to one of Read, Write, Admin, or None.
8. Optional. Add a team member or robot account. To add a team member, enter the name of their Red Hat Quay account.

9. Review and finish the information, then click Review and Finish. The new team appears under the Teams and membership page. From here, you can click the kebab menu, and select one of the following options:

   • Manage Team Members. On this page, you can view all members, team members, robot accounts, or users who have been invited. You can also add a new team member by clicking Add new member.
   • Set repository permissions. On this page, you can set the repository permissions to one of Read, Write, Admin, or None.
   • Delete. This popup windows allows you to delete the team by clicking Delete.

10. Optional. You can click the one of the following options to reveal more information about teams, members, and collaborators:

    • Team View. This menu shows all team names, the number of members, the number of repositories, and the role for each team.
    • Members View. This menu shows all usernames of team members, the teams that they are part of, the repository permissions of the user.
    • Collaborators View. This menu shows repository collaborators. Collaborators are users that do not belong to any team in the organization, but who have direct permissions on one or more repositories belonging to the organization.

Procedure

1. On the v2 UI, click Organizations.
2. Click the name of the organization that you will create the robot account for, for example, test-org.
3. Click the Robot accounts tab Create robot account.
4. In the Provide a name for your robot account box, enter a name, for example, robot1.

5. Optional. The following options are available if desired:

   1. Add the robot to a team.
   2. Add the robot to a repository.
   3. Adjust the robot’s permissions.

6. On the Review and finish page, review the information you have provided, then click Review and finish. The following alert appears: Successfully created robot account with robot name: <organization_name> + <robot_name>.

   Alternatively, if you tried to create a robot account with the same name as another robot account, you might receive the following error message: Error creating robot account.

7. Optional. You can click Expand or Collapse to reveal descriptive information about the robot account.
8. Optional. You can change permissions of the robot account by clicking the kebab menu Set repository permissions. The following message appears: Successfully updated repository permission.
9. Optional. To delete your robot account, check the box of the robot account and click the trash can icon. A popup box appears. Type confirm in the text box, then, click Delete. Alternatively, you can click the kebab menu Delete. The following message appears: Successfully deleted robot account.

Procedure

1. Click the name of an organization.
2. Click Default permissions.
3. Click create default permissions. A toggle drawer appears.

4. Select either Anyone or Specific user to create a default permission when a repository is created.

   1. If selecting Anyone, the following information must be provided:

      • Applied to. Search, invite, or add a user/robot/team.
      • Permission. Set the permission to one of Read, Write, or Admin.

   2. If selecting Specific user, the following information must be provided:

      • Repository creator. Provide either a user or robot account.
      • Applied to. Provide a username, robot account, or team name.
      • Permission. Set the permission to one of Read, Write, or Admin.
5. Click Create default permission. A confirmation box appears, returning the following alert: Successfully created default permission for creator.

Procedure

1. On the v2 UI, click Organizations.
2. Click the name of the organization that you will create the robot account for, for example, test-org.
3. Click the Settings tab.
4. Optional. Enter the email address associated with the organization.

5. Optional. Set the allotted time for the Time Machine feature to one of the following:

   • 1 week
   • 1 month
   • 1 year
   • Never
6. Click Save.

Procedure

1. On the v2 UI, click Repositories.
2. Click the name of a repository, for example, quayadmin/busybox.

3. Click the name of the tag, for example, test. You are taken to the Details page of the tag. The page reveals the following information:

   • Name
   • Repository
   • Digest
   • Vulnerabilities
   • Creation
   • Modified
   • Size
   • Labels
   • How to fetch the image tag
4. Optional. Click Security Report to view the tag’s vulnerabilities. You can expand an advisory column to open up CVE data.
5. Optional. Click Packages to view the tag’s packages.
6. Click the name of the repository, for example, busybox, to return to the Tags page.
7. Optional. Hover over the Pull icon to reveal the ways to fetch the tag.
8. Check the box of the tag, or multiple tags, click the Actions drop down menu, and then Delete to delete the tag. Confirm deletion by clicking Delete in the popup box.

Procedure

1. On the v2 UI, click Repositories.
2. Click the name of a repository, for example, quayadmin/busybox.
3. Click the Settings tab.
4. Optional. Click User and robot permissions. You can adjust the settings for a user or robot account by clicking the dropdown menu option under Permissions. You can change the settings to Read, Write, or Admin.

5. Optional. Click Events and notifications. You can create an event and notification by clicking Create Notification. The following event options are available:

   • Push to Repository
   • Package Vulnerability Found
   • Image build failed
   • Image build queued
   • Image build started
   • Image build success

   • Image build cancelled

     Then, issue a notification. The following options are available:

   • Email Notification
   • Flowdock Team Notification
   • HipChat Room Notification
   • Slack Notification

   • Webhook POST

     After selecting an event option and the method of notification, include a Room ID #, a Room Notification Token, then, click Submit.

6. Optional. Click Repository visibility. You can make the repository private, or public, by clicking Make Public.
7. Optional. Click Delete repository. You can delete the repository by clicking Delete Repository.