Skip to content

Commit 8206bf4

Browse files
authored
Merge pull request #743 from metafacture/releaseIssueTemplate
2 parents 27adf02 + cb611f9 commit 8206bf4

2 files changed

Lines changed: 43 additions & 59 deletions

File tree

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
name: Release A.B.C
3+
about: Steps for each release
4+
title: 'Release A.B.C'
5+
labels: ''
6+
assignees: '@TobiasNx'
7+
8+
---
9+
10+
The release is based on commit [specify commit hash that is going to be released so that the exact version will be tested]
11+
12+
13+
This release follows release A.B.C + LINK TO RELEASE ISSUE
14+
15+
Following [maintaining guidelines](https://github.com/metafacture/metafacture-core/blob/master/MAINTAINING.md).
16+
17+
- [ ] update dependencies if these are promising to not break much
18+
- [ ] test with locally built `master-SNAPSHOT`
19+
- [ ] lobid-organisations (by @TobiasNx)
20+
- [ ] lobid-resources (by @TobiasNx)
21+
- [ ] lobid-extra-holdings (by @TobiasNx)
22+
- [ ] oersi (by @TobiasNx)
23+
- [ ] limetrans (by @blackwinter)
24+
- [ ] [release on maven central](https://central.sonatype.com/search?q=metafacture)
25+
- [ ] [release on github](https://github.com/metafacture/metafacture-core/releases/)
26+
- [ ] update [metafacture-playground](https://github.com/metafacture/metafacture-playground/issues/221)
27+
- [ ] update [flux-commands](https://github.com/metafacture/metafacture-documentation/blob/master/docs/Documentation-Maintainer-Guide.md)
28+
- [ ] update [metafacture-fix functions](https://github.com/metafacture/metafacture-documentation/blob/master/docs/fix/Fix-functions.md)
29+
- [ ] write [blog post](https://github.com/metafacture/metafacture-blog/issues/39)
30+
- [ ] [toot](https://openbiblio.social/@metafacture/)
31+
- [ ] announce at [metadaten.community](https://metadaten.community/c/software-und-tools/metafacture/8)

MAINTAINING.md

Lines changed: 12 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -65,12 +65,19 @@ sonatypeUsername=$usernameOfToken
6565
sonatypePassword=$passwordOfToken
6666
```
6767

68-
## Upload, test, publish a release
68+
## Test, upload, publish a release
6969

70-
There are no more "Release candidates" as such, but the uploaded, validated
71-
[deployment bundle can be
72-
tested](https://central.sonatype.org/publish/publish-portal-api/#manually-testing-a-deployment-bundle).
73-
I.e. you first upload a release and before publishing it you test it.
70+
### Test
71+
72+
In metafacture-core:
73+
74+
1. Change to intended current master or specific commit
75+
2. Build locally `./gradlew publishToMavenLocal`
76+
77+
In your project:
78+
79+
3. set your project dependency to `master-SNAPSHOT`
80+
4. Run your tests of your project
7481

7582
### Upload
7683

@@ -92,60 +99,6 @@ a) It's going from your local Git repository to central.sonatype.com to Maven Ce
9299
```
93100
./gradlew publishToSonatype -PpublishVersion=A.B.C closeSonatypeStagingRepository
94101
```
95-
### Test
96-
97-
_As a fallback and for build systems where the below does not work:
98-
git checkout the release tag resp. the branch, build locally and consume locally. You don't need
99-
to have a login then, no special configs etc._
100-
101-
If you decide to test what is actually in the pipeline you need some
102-
prerequisites;
103-
You need to have a login at central.sonatype.com and be added as a
104-
maintainer of the namespace `org.metafacture`.
105-
Follow the section "Authorize at central sonatype" to be able to test the
106-
deployment bundle.
107-
108-
You have to add this into you `~/.m2/settings.xml`:
109-
```
110-
<servers>
111-
<server>
112-
<id>central.manual.testing</id>
113-
<configuration>
114-
<httpHeaders>
115-
<property>
116-
<name>Authorization</name>
117-
<value>Bearer $basencodedUsernameAndPassword</value>
118-
</property>
119-
</httpHeaders>
120-
</configuration>
121-
</server>
122-
</servers>
123-
124-
<profiles>
125-
<profile>
126-
<id>central.manual.testing</id>
127-
<repositories>
128-
<repository>
129-
<id>central.manual.testing</id>
130-
<name>Central Testing repository</name>
131-
<url>https://central.sonatype.com/api/v1/publisher/deployments/download</url>
132-
</repository>
133-
</repositories>
134-
</profile>
135-
</profiles>
136-
```
137-
where `basencodedUsernameAndPassword` is created like this:
138-
```
139-
printf "$usernameToken:$passwordToken" | base64
140-
```
141-
(note the semicolon `:`).
142-
143-
If you have a maven project you can now update the dependencies in the
144-
`pom.xml` and download the like:
145-
146-
```
147-
mvn -debug -Pcentral.manual.testing install
148-
```
149102
150103
### Publish
151104

0 commit comments

Comments
 (0)