Skip to content

Commit 3c0d242

Browse files
committed
ICU-22606 Create full release from CI - update docs
1 parent ae7159d commit 3c0d242

File tree

2 files changed

+96
-1
lines changed

2 files changed

+96
-1
lines changed

docs/processes/release/tasks/publish/index.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -241,16 +241,22 @@ Download Directories are located at, for example,
241241
corresponding to <http://download.icu-project.org/ex/files/icu4c/4.4.2/>
242242
Look at previous releases for an example.
243243

244-
### Java Source/Bin:
244+
### Java Source/Bin
245+
246+
**Post 76.1 see [Publish - Version 76.1](release.md)**
245247

246248
Follow instructions here: [Building ICU4J Release Files](../release-build.md)
247249

248250
### C source/binary:
249251

252+
**Post 76.1 see [Publish - Version 76.1](release.md)**
253+
250254
<span style="background:yellow">***WORK IN PROGRESS***</a>
251255

252256
#### Source and Linux Binaries:
253257

258+
**Post 76.1 see [Publish - Version 76.1](release.md)**
259+
254260
Important: this step works with Unix make + docker.
255261

256262
First, install *docker* and *docker-compose. D*o not proceed until *docker run
@@ -285,6 +291,9 @@ run \`make dist\`.
285291

286292
#### Windows Binary:
287293

294+
**Post 76.1 see [Publish - Version 76.1](release.md)** \
295+
That new flow overlaps with _"Using the output from the build bots"_ below.
296+
288297
* Manual process:
289298
* Build with MSVC x64 Release. (See the ICU
290299
[readme.html](https://github.com/unicode-org/icu/main/blob/icu4c/readme.html)
@@ -345,6 +354,8 @@ run \`make dist\`.
345354
346355
#### Output of icuexportdata:
347356
357+
**Post 76.1 see [Publish - Version 76.1](release.md)**
358+
348359
This step publishes pre-processed Unicode property data, which may be ingested by downstream clients such as ICU4X.
349360
350361
* Using the output from the build bots:
@@ -354,6 +365,8 @@ This step publishes pre-processed Unicode property data, which may be ingested b
354365
355366
### Signing archives and creating checksums:
356367
368+
**Post 76.1 see [Publish - Version 76.1](release.md)**
369+
357370
#### Step 0. PGP keys:
358371
359372
Use your own personal PGP key. Make sure that at least one other member of the
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
layout: default
3+
title: Publish - Version 76.1 - WIP
4+
parent: Release & Milestone Tasks
5+
grand_parent: Contributors
6+
nav_order: 90
7+
---
8+
9+
<!--
10+
© 2024 and later: Unicode, Inc. and others.
11+
License & terms of use: http://www.unicode.org/copyright.html
12+
-->
13+
14+
# Publish - Version 76.1 - WIP
15+
{: .no_toc }
16+
17+
## Contents
18+
{: .no_toc .text-delta }
19+
20+
---
21+
22+
## Most artifacts are now built in the GitHub CI. Work in Progress!!!
23+
24+
Many of the tasks that used to be done before "by hand" are now at least
25+
partially done by GitHub Actions.
26+
27+
The release requires (for now) triggering the actions "by hand".
28+
29+
First go to [Github - unicode-org/icu](https://github.com/unicode-org/icu).
30+
31+
Create a release, give it a tag (something like `release-76` or `release-74-2`) \
32+
Make sure the release is **DRAFT**.
33+
34+
See [Release & Milestone Tasks - Tagging](index.md#tagging) for details.
35+
36+
That tag will need to be passed to several of the actions below.
37+
38+
Go to [Github - unicode-org/icu](https://github.com/unicode-org/icu) -- Actions
39+
and select the action to run from the left side.
40+
41+
Select an action and (from the right side) select "Run workflow".
42+
43+
Some actions will have an "Run the tests." option. \
44+
**KEEP IT ON!** It is there for development, but you MUST run the tests for release.
45+
46+
Most will have a "Release tag to upload to." option. \
47+
Here you should use the release tag.
48+
49+
1. **GHA ICU4C** \
50+
This will create and add to release: \
51+
* The Windows binaries (`icu4c-{icuver}-Win32-MSVC20??.zip`,
52+
`icu4c-{icuver}-Win64-MSVC20??.zip`, `icu4c-{icuver}-WinARM64-MSVC20??.zip`)
53+
* The packaged data for ICU4X (`icuexportdata_tag-goes-here.zip`)
54+
55+
1. **Release - ICU4C artifacts on Fedora** (`release-icu4c-fedora.yml`) \
56+
This will create and add to release:
57+
* `icu4c-{icuver}-Fedora_Linux??-x64.tgz`.
58+
59+
1. **Release - ICU4C artifacts on Ubuntu** (`release-icu4c-ubuntu.yml`) \
60+
This will create and add to release:
61+
* The `icu4c-{icuver}-Ubuntu??.04-x64.tgz` file
62+
* The icu4c data files (`icu4c-{icuver}-data.zip`,
63+
`icu4c-{icuver}-data-bin-b.zip`, `icu4c-{icuver}-data-bin-l.zip`)
64+
* The icu4c source archives (`icu4c-{icuver}-src.tgz` and `icu4c-{icuver}-src.zip`)
65+
* The ICU4C documentation (`icu4c-76_1-docs.zip`) \
66+
**WARNING:** this is also the one to be published (unpacked) for web access
67+
68+
1. **Release - ICU4J publish to Maven Central** (`release-icu4j-maven.yml`) \
69+
This will create, publish to Maven Cental (using Sonatype), and add to release:
70+
* All the official Maven artifacts, including sources and javadoc. \
71+
The Maven Central artifacts have checksums and are digitally signed. \
72+
Someone with access to Sonatype Nexus should still login there and authorize
73+
the promotion to Maven Central.
74+
* The unified Java documentation, (`icu4j-76.1-fulljavadoc.jar`) \
75+
**WARNING:** this is also the one to be published (unpacked) for web access
76+
77+
1. **Release - Create checksums and GPG sign** (`release-check-sign.yml`) \
78+
THIS SHOULD BE THE LAST ACTION YOU RUN. \
79+
After all the artifacts from the previous steps are posted to the release. \
80+
The action will download all the artifacts from release,
81+
create checksum files (`SHASUM512.txt` and `*.md5`),
82+
and digital signature files (`*.asc`)

0 commit comments

Comments
 (0)