Skip to content

Commit 46fb774

Browse files
stevsmitSteven Smith
andauthored
Adds 3.15.1 release notes and mirroring feature (quay#1393)
Co-authored-by: Steven Smith <[email protected]>
1 parent 267b193 commit 46fb774

File tree

5 files changed

+93
-50
lines changed

5 files changed

+93
-50
lines changed

modules/attributes.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ ifeval::["{productname}" == "Project Quay"]
1616
:productname: Project Quay
1717
:productversion: 3
1818
:producty: 3.15
19-
:productminv: v3.15.0
19+
:productminv: v3.15.1
2020
:productrepo: quay.io/projectquay
2121
:quayimage: quay
2222
:clairimage: clair
@@ -33,8 +33,8 @@ ifeval::["{productname}" == "Red Hat Quay"]
3333
:productversion: 3
3434
:producty: 3.15
3535
:producty-n1: 3.14
36-
:productmin: 3.15.0
37-
:productminv: v3.15.0
36+
:productmin: 3.15.1
37+
:productminv: v3.15.1
3838
:productrepo: registry.redhat.io/quay
3939
:clairnewver: v3.14
4040
:quayimage: quay-rhel8

modules/config-ui-mirroring.adoc

Lines changed: 15 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,18 @@
1-
= Mirroring configuration UI
1+
:_mod-docs-content-type: PROCEDURE
2+
[id="mirroring-configuration"]
3+
= Enabling repository mirroring
24

3-
. Start the `Quay` container in configuration mode and select the Enable Repository Mirroring check box. If you want to require HTTPS communications and verify certificates during mirroring, select the HTTPS and cert verification check box.
5+
By default, `FEATURE_REPO_MIRROR` is set to `false`. To enable mirroring, you must set `FEATURE_REPO_MIRROR: true` in your `config.yaml` file.
6+
7+
.Procedure
8+
9+
. Set `FEATURE_REPO_MIRROR: true` in your `config.yaml` file. For example:
410
+
5-
image:repo_mirror_config.png[Enable mirroring and require HTTPS and verified certificates]
11+
[source,yaml]
12+
----
13+
# ...
14+
FEATURE_REPO_MIRROR: true
15+
# ...
16+
----
617

7-
. Validate and download the `configuration` file, and then restart Quay in registry mode using the updated config file.
18+
. Restart your {productname} registry.

modules/mirroring-creating-repo.adoc

Lines changed: 28 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,7 @@
22
[id="mirroring-creating-repo"]
33
= Creating a mirrored repository
44

5-
When mirroring a repository from an external container registry, you must create a new private repository. Typically, the same name is used as the target repository, for example, `quay-rhel8`.
6-
7-
image:repo_quay_rhel8.png[Create new {productname} repo]
5+
When mirroring a repository from an external container registry, you must create a new private repository. Typically, the same name is used as the target repository, for example, `quay-rhel9`.
86

97
[id="mirroring-repository-mirroring-settings"]
108
== Repository mirroring settings
@@ -18,37 +16,42 @@ Use the following procedure to adjust the settings of your mirrored repository.
1816

1917
.Procedure
2018

21-
. In the Settings tab, set the Repository State to `Mirror`:
22-
+
23-
image:repo_mirror_create.png[Create a new {productname} repo mirror]
19+
. Navigate to the *Repositories* page of your registry and click the name of a repository, for example, *test-mirror*.
2420

25-
. In the Mirror tab, enter the details for connecting to the external registry, along with the tags, scheduling and access information:
26-
+
27-
image:repo-mirror-details-start.png[Repository mirroring]
21+
. Click *Settings* -> *Repository state*.
22+
23+
. Click *Mirror*.
24+
25+
. Click the *Mirroring* tab and enter the details for connecting to the external registry, along with the tags, scheduling and access information:
2826

2927
. Enter the details as required in the following fields:
3028
+
31-
* **Registry Location:** The external repository you want to mirror, for example, `registry.redhat.io/quay/quay-rhel8`
32-
* **Tags:** This field is required. You may enter a comma-separated list of individual tags or tag patterns. (See _Tag Patterns_ section for details.)
29+
* **Registry Location:** The external repository you want to mirror, for example, `registry.redhat.io/quay/quay-rhel8`.
30+
31+
* **Tags:** Enter a comma-separated list of individual tags or tag patterns. (See _Tag Patterns_ section for details.)
3332

3433
* **Start Date:** The date on which mirroring begins. The current date and time is used by default.
34+
3535
* **Sync Interval:** Defaults to syncing every 24 hours. You can change that based on hours or days.
36+
37+
* **Skopeo timeout internal:** Defaults to `300` seconds (5 minutes). The maximum timeout length is `43200` seconds (12 hours).
38+
3639
* **Robot User:** Create a new robot account or choose an existing robot account to do the mirroring.
40+
3741
* **Username:** The username for accessing the external registry holding the repository you are mirroring.
42+
3843
* **Password:** The password associated with the Username. Note that the password
3944
cannot include characters that require an escape character (\).
4045

41-
[id="mirroring-advanced-settings"]
42-
== Advanced settings
43-
44-
In the *Advanced Settings* section, you can configure SSL/TLS and proxy with the following options:
45-
46+
. In the *Advanced Settings* section, you can optionally configure SSL/TLS and proxy with the following options:
47+
+
4648
* **Verify TLS:** Select this option if you want to require HTTPS and to verify certificates when communicating with the target remote registry.
4749
* **Accept Unsigned Images:** Selecting this option allows unsigned images to be mirrored.
4850
* **HTTP Proxy:** Select this option if you want to require HTTPS and to verify certificates when communicating with the target remote registry.
4951
* **HTTPS PROXY:** Identify the HTTPS proxy server needed to access the remote site, if a proxy server is needed.
5052
* **No Proxy:** List of locations that do not require proxy.
5153

54+
. After filling out all information, click *Enable Mirror*.
5255

5356
[id="mirroring-synchronize-now"]
5457
== Synchronize now
@@ -57,14 +60,12 @@ Use the following procedure to initiate the mirroring operation.
5760

5861
.Procedure
5962

60-
* To perform an immediate mirroring operation, press the Sync Now button on the repository's Mirroring tab. The logs are available on the Usage Logs tab:
61-
+
62-
image:repo-mirror-usage-logs.png[Usage logs]
63-
+
64-
When the mirroring is complete, the images will appear in the Tags tab:
65-
+
66-
image:repo-mirror-tags.png[Repository mirroring tags]
67-
+
68-
Below is an example of a completed Repository Mirroring screen:
69-
+
70-
image:repo-mirror-details.png[Repository mirroring details]
63+
. Navigate to the *Mirroring* tab of your repository.
64+
65+
. Press the *Sync Now* button.
66+
67+
.Verification
68+
69+
. Click the *Logs* tab to view available logs.
70+
71+
. When mirroring is complete, the image appear in the *Tags* tab.

modules/mirroring-working-with.adoc

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
1-
[[mirroring-working-with]]
1+
:_mod-docs-content-type: PROCEDURE
2+
[id="mirroring-working-with"]
23
= Working with mirrored repositories
34

4-
Once you have created a mirrored repository, there are several
5-
ways you can work with that repository.
6-
Select your mirrored repository from the Repositories page
7-
and do any of the following:
5+
After you have created a mirrored repository, there are several ways that you can work with that repository.
6+
7+
Select your mirrored repository from the *Repositories* page to do any of the following:
88

99
* **Enable/disable the repository**: Select the Mirroring button in the left column,
1010
then toggle the Enabled check box to enable or disable the repository temporarily.
1111
1212
* **Check mirror logs**: To make sure the mirrored repository is working properly,
1313
you can check the mirror logs. To do that, select the Usage Logs
1414
button in the left column. Here's an example:
15-
+
16-
image:repo_mirror_logs.png[View logs for your {productname} repo mirror]
15+
1716
1817
* **Sync mirror now**: To immediately sync the images in your repository,
1918
select the Sync Now button.
@@ -28,22 +27,17 @@ new ones from being synced, select the CANCEL button.
2827
for accessing external repositories. By assigning credentials to a robot, that robot can be used
2928
across multiple mirrored repositories that need to access the same external registry.
3029
+
31-
You can assign an existing robot to a repository by going to Account Settings, then selecting
32-
the Robot Accounts icon in the left column. For the robot account, choose the
33-
link under the REPOSITORIES column. From the pop-up window, you can:
30+
You can assign an existing robot to a repository by navigating to *Organizations* -> *Robot accounts*. On this page, you can view the following information:
3431
3532
** Check which repositories are assigned to that robot.
3633

37-
** Assign read, write or Admin privileges to that robot from the PERMISSION field shown in this figure:
38-
image:repo_mirror_robot_assign.png[Assign a robot to mirrored repo]
34+
** Assign `Read`, `Write` or `Admin` privileges to that robot from the PERMISSION field.
3935

4036
* **Change robot credentials**: Robots can hold credentials such as
41-
Kubernetes secrets, Docker login information, and Mesos bundles.
37+
Kubernetes secrets, Docker login information, and Podman login information.
4238
To change robot credentials, select
4339
the Options gear on the robot's account line on the Robot Accounts window and choose View Credentials.
4440
Add the appropriate credentials for the external repository the robot needs to access.
45-
+
46-
image:repo_mirror_robot_perm.png[Assign permission to a robot]
4741
4842
* **Check and change general setting**: Select the Settings button (gear icon) from the left
4943
column on the mirrored repository page.

modules/rn_3_15_0.adoc

Lines changed: 38 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,42 @@
1+
:_content-type: CONCEPT
2+
[id="release-notes-315"]
3+
= {productname} release notes
4+
5+
The following sections detail _y_ and _z_ stream release information.
6+
7+
[id="rn-3-15-1"]
8+
== RHBA-2025:7674 - {productname} 3.15.1 release
9+
10+
Issued 2025-08-14
11+
12+
{productname} release 3.15.1 is now available with Clair {clairproductminv}. The bug fixes that are included in the update are listed in the link:https://access.redhat.com/errata/RHBA-2025:13256[RHBA-2025:13256] advisory.
13+
14+
[id="bug-fixes-315-1-new-features"]
15+
=== {productname} 3.15.1 new features
16+
17+
The following features have been added with {productname} 3.15.1.
18+
19+
[id="v2-ui-mirroring-tab"]
20+
==== v2 UI mirroring tab
21+
22+
Previously, mirroring via the {productname} UI was only available when using the legacy UI. With this update, a *Mirroring* tab has been added to the {productname} v2 UI. This tab is available under the *Repositories* page of your registry.
23+
24+
For more information, see link:https://docs.redhat.com/en/documentation/red_hat_quay/3/html/manage_red_hat_quay/repo-mirroring-in-red-hat-quay[Repository mirroring].
25+
26+
[id="bug-fixes-315-1"]
27+
=== {productname} 3.15.1 bug fixes
28+
29+
* link:https://issues.redhat.com/browse/PROJQUAY-9135[PROJQUAY-9135]. Before this update, Alembic migrations failed to install certificates during run, causing issues with {productname} behind HTTPS proxy due to lack of certificates. Consequently, users experienced migration failure when {productname} was behind an HTTPS proxy. With this release, Alembic migrations no longer require manual certificate installation for {productname} behind HTTPS proxy. As a result, Alembic migrations can now install certs, allowing smooth operation behind HTTPS proxies.
30+
31+
* link:https://issues.redhat.com/browse/PROJQUAY-9156[PROJQUAY-9156]. Previously, some `read-only` permissions were missing for `read-only` superusers. This issue has been resolved.
32+
33+
* link:https://issues.redhat.com/browse/PROJQUAY-9106[PROJQUAY-9106]. Previously, a bad proxy cache reference occurred due to an oversight. Consequently, users experienced stale cache data. With this release, the proxy cache reference issue is resolved, ensuring smoother performance for end users.
34+
35+
* link:https://issues.redhat.com/browse/PROJQUAY-9059[PROJQUAY-9059]. With this release, model card rendering is now enabled on the v2 UI by default. You no longer need to set the `FEATURE_UI_MODELCARD` field to `true`.
36+
37+
138
[id="rn-3-15-0"]
2-
= RHBA-2025:8408 - {productname} 3.15.0 release
39+
== RHBA-2025:8408 - {productname} 3.15.0 release
340

441
Issued 2025-07-07
542

0 commit comments

Comments
 (0)