|
1 | | -# Legacy Releases from SVN Dist |
2 | | - |
3 | | -We have three types of Releases to create using a "Pull from 'Dist'" process. |
4 | | - |
5 | | -1. Release Candidates from `dist/dev` as the Release Manager requests from within the ATR Web UI. |
6 | | - |
7 | | -2. Current Releases from `dist/release` this will be used for the initial migration and may be used from time to time as PMCs use the old methods. |
8 | | - |
9 | | -3. Archived Releases which are migrated from the archive if not present in the Current Releases. |
10 | | - |
11 | | -## ATR Web UX |
12 | | - |
13 | | -We will need pages to perform tasks related to the use of our legacy setup. |
14 | | - |
15 | | -### PMC Management Page |
16 | | - |
17 | | -1. **Create Release Candidate** - upload the packages for a release candidate from `svn:dist/dev`. This page can also handle direct uploads. |
18 | | - |
19 | | -3. **Legacy Release** - upload an approved release from `svn:dist/release`. |
20 | | - |
21 | | -### System Admin Page |
22 | | - |
23 | | -1. **Synchronise Current Releases** - scan `svn:dist/release` and migrate any not in the ATR. |
24 | | - |
25 | | -2. **Synchronize Release Archive** - scan `archive` repository and migrate any archived not in the ATR as a Current or Archived Release. |
26 | | - |
27 | | -## Backends Hosting Release Artifacts |
28 | | - |
29 | | -The legacy domains are currently connected to `svn:dist/release` as follows: |
30 | | - |
31 | | -1. rsync.apache.org has a directory that updates a checkout of `svn:dist/release` |
32 | | -2. downloads.apache.org periodically rsyncs with rsync.apache.org |
33 | | -3. archive.apache.org periodically rsyncs with rsync.apache.org without removing artifacts from the destination. |
34 | | - |
35 | | -### Transitional Steps |
36 | | - |
37 | | -```mermaid |
38 | | -flowchart TD |
39 | | - subgraph Legacy |
40 | | - A[svn:dist/release] |
41 | | - B[rsync.apache.org] |
42 | | - A -->|svn| B |
43 | | - C@{ shape: processes, label: "downloads.apache.org"} |
44 | | - D[archive.apache.org] |
45 | | - B -->|rsync| C |
46 | | - B -->|rsync| D |
47 | | - end |
48 | | -``` |
49 | | - |
50 | | -1. **ATR writes to SVN** - ATR Releases write to `svn:dist/release` as an interim step. |
51 | | - |
52 | | -```mermaid |
53 | | -flowchart TD |
54 | | - subgraph Transition 1 |
55 | | - ATR[releases.apache.org] |
56 | | - A[svn:dist/release] |
57 | | - ATR -->|svn| A |
58 | | - B[rsync.apache.org] |
59 | | - A -->|svn| B |
60 | | - C@{ shape: processes, label: "downloads.apache.org"} |
61 | | - D[archive.apache.org] |
62 | | - B -->|rsync| C |
63 | | - B -->|rsync| D |
64 | | - end |
65 | | -``` |
66 | | - |
67 | | -2. **ATR and Legacy are Integrated** - Insert ATR into the rsync chain. |
68 | | - - ATR has a directory with the same organization as `svn:dist/release` using symbolic links to the Releases in the ATR Datastore. |
69 | | - |
70 | | - - (a) ATR's rsync from rsync.apache.org should detect legacy release addition and deletion. |
71 | | - |
72 | | -```mermaid |
73 | | -flowchart TD |
74 | | - subgraph Transition 2A |
75 | | - A[svn:dist/release] |
76 | | - B[rsync.apache.org] |
77 | | - A -->|svn| B |
78 | | - ATR[releases.apache.org] |
79 | | - B -->|rsync| ATR |
80 | | - C@{ shape: processes, label: "downloads.apache.org"} |
81 | | - D[archive.apache.org] |
82 | | - ATR -->|rsync| C |
83 | | - ATR -->|rsync| D |
84 | | - end |
85 | | -``` |
86 | | - |
87 | | - Or |
88 | | - |
89 | | - - (b) ATR coexists on rsync.apache.org and detects legacy release addition and deletion. |
90 | | - |
91 | | -```mermaid |
92 | | -flowchart TD |
93 | | - subgraph Transition 2B |
94 | | - A[svn:dist/release] |
95 | | - subgraph ATR on Rsync |
96 | | - ATR[releases.apache.org] |
97 | | - B[rsync.apache.org] |
98 | | - ATR <--> B |
99 | | - end |
100 | | - A -->|svn| ATR |
101 | | - C@{ shape: processes, label: "downloads.apache.org"} |
102 | | - D[archive.apache.org] |
103 | | - B -->|rsync| C |
104 | | - B -->|rsync| D |
105 | | - end |
106 | | -``` |
107 | | - |
108 | | -3. **Legacy is Retired** - `svn:dist/release` is retired. |
109 | | - |
110 | | -```mermaid |
111 | | -flowchart TD |
112 | | - subgraph Transition 3 |
113 | | - ATR[releases.apache.org] |
114 | | - C@{ shape: processes, label: "downloads.apache.org"} |
115 | | - D[archive.apache.org] |
116 | | - ATR -->|rsync| C |
117 | | - ATR -->|rsync| D |
118 | | - end |
119 | | -``` |
120 | | - |
121 | | -4. **Further Integration** - downloads.apache.org is hosted on ATR. Downloads.apache.org is multiple servers. ATR would need to work on multiple servers |
122 | | - |
123 | | -```mermaid |
124 | | -flowchart TD |
125 | | - subgraph Transition 4 |
126 | | - ATR@{ shape: processes, label: "releases.apache.org"} |
127 | | - D[archive.apache.org] |
128 | | - ATR -->|rsync| D |
129 | | - end |
130 | | -``` |
| 1 | +Replaced by [webpage](https://tooling.apache.org/svn-dist.html) - [source file](https://github.com/apache.tooling-docs/main/content/pages/svn-dist.md) |
0 commit comments