harbor/docs/1.10/working-with-projects/project-configuration/_index.md

49 lines
2.5 KiB
Markdown
Raw Normal View History

---
title: Project Configuration
2020-02-11 16:24:43 +01:00
weight: 30
---
2019-10-17 15:47:25 +02:00
2020-01-15 15:05:07 +01:00
After the initial creation of a project, you can configure or reconfigure its properties in the **Configuration** tab for that project.
2019-10-17 15:47:25 +02:00
2020-01-15 15:05:07 +01:00
1. Log in to the Harbor interface with an account that has at least project administrator privileges.
1. Go to **Projects** and select a project.
1. Select the **Configuration** tab.
1. To make all repositories under the project accessible to everyone, select the `Public` checkbox, or deselect this checkbox to make the project private.
1. To prevent un-signed images under the project from being pulled, select the `Enable content trust` checkbox.
2019-10-17 15:47:25 +02:00
![browse project](../../img/project-configuration.png)
2019-10-17 15:47:25 +02:00
## Searching projects and repositories
2020-01-15 15:05:07 +01:00
Enter a keyword in the search field at the top to list all matching projects and repositories. The search result includes both public and private repositories you have access to.
2019-10-17 15:47:25 +02:00
![browse project](../../img/new-search.png)
2019-10-17 15:47:25 +02:00
2019-12-13 15:08:40 +01:00
## Configure Vulnerability Settings in Projects
You can configure projects so that images with vulnerabilities cannot be run, and to automatically scan images as soon as they are pushed into the project.
1. Log in to the Harbor interface with an account that has at least project administrator privileges.
1. Go to **Projects** and select a project.
1. Select the **Configuration** tab.
1. To prevent vulnerable images under the project from being pulled, select the **Prevent vulnerable images from running** checkbox.
![Prevent vulnerable images from running](../../img/prevent-vulnerable-images.png)
2019-12-13 15:08:40 +01:00
1. Select the severity level of vulnerabilities to prevent images from running.
![Set vulnerability threshold](../../img/set-vulnerability-threshold.png)
2019-12-13 15:08:40 +01:00
Images cannot be pulled if their level is equal to or higher than the selected level of severity. Harbor does not prevent images with a vulnerability severity of `negligible` from running.
1. To activate an immediate vulnerability scan on new images that are pushed to the project, select the **Automatically scan images on push** check box.
![Automatically scan images on push](../../img/scan-on-push.png)
2019-12-13 15:08:40 +01:00
2019-10-17 15:47:25 +02:00
## Build history
2019-12-13 15:08:40 +01:00
Build history makes it easy to see the contents of a container image, find the code which builds an image, or locate the image for a source repository.
2019-10-17 15:47:25 +02:00
In Harbor portal, enter your project, select the repository, click on the link of tag name you'd like to see its build history, the detail page will be opened. Then switch to `Build History` tab, you can see the build history information.
![build history](../../img/build-history.png)