Merge branch 'cursor/release-replace' into 'stage'
@@ -126,6 +126,18 @@ curl -fsS -X POST "$CI_API_URL/repos/$CI_PROJECT_PATH/releases" \
126
126
127
127
Het commit moet in de repository bestaan. Het asset moet een artifact zijn van een geslaagde job in dezelfde pipeline. Een beheerder kan met een persoonlijk token een release zonder assets maken. Een tag is `A-Za-z0-9._-`, tot 80 tekens, en wordt ook een annotated git-tag.
128
128
129
### Eigen release vervangen
130
131
Een release bestaat maar één keer: dezelfde tag nog eens publiceren geeft `409`. Een job kan zijn eigen release wel vervangen met `"replace": true` in de body, bijvoorbeeld voor een doorlopende experimentele release. BlueGit verwijdert dan de oude release, de assets en de git-tag en maakt ze opnieuw op het nieuwe commit. Er komt nooit een tweede release met dezelfde tag. Dat mag alleen als al deze regels gelden:
132
133
- Het verzoek komt met `CI_JOB_TOKEN` van een lopende job in hetzelfde project. Een persoonlijk token of een job uit een ander project kan niet vervangen (`403` of `401`).
134
- De pipeline draait op een branch (`refs/heads/…`) die niet beschermd is. Een beschermde branch zoals `master`, een tag-pipeline en `forks/*` krijgen dit recht nooit (`403`). Een stabiele release vanaf `master` blijft daardoor altijd staan.
135
- De tag past niet op een beschermd tagpatroon.
136
- De pipeline is veroorzaakt door een maintainer of hoger van het project (de `actor`: wie pushte, mergede of de run startte), of door een instance-admin. Een ontwikkelaar, een onbekende of lege actor krijgt `403`.
137
- De bestaande release is door een job gemaakt in een pipeline op dezelfde branch. Een release die met de hand of vanaf een andere ref is gemaakt, blijft staan (`409`).
138
139
De assets worden eerst gecontroleerd, pas daarna gaat de oude release weg. Elke vervanging schrijft een regel `release audit` met `action=replace`, repository, tag, oud en nieuw commit, job, pipeline, ref en actor in het serverlog. Zonder `replace` blijft alles zoals het was.
140
129
141
## Wanneer een job start
130
142
131
143
`Gate` in `internal/ci` geeft `ready`, `wait`, `skip` of `fail`. `skip` volgt op een harde mislukking bij `when: on_success`, of op succes bij `when: on_failure`. `when: always` wacht tot de voorgangers klaar zijn en draait dan toch. Een job met `allow_failure` telt niet als harde mislukking. De runner verwerkt pipelines elke twee seconden, met `ci.concurrency` tegelijk (standaard 1). Jobs die al lopen vullen die slots. Een startklare job die nog wacht toont `In wachtrij (#n)` in de pipelines-lijst, de stage-popover en op de jobpagina. Het nummer is de plek in Steves globale wachtrij, over alle repositories; de eerstvolgende wachtende job is `#1`.
@@ -126,6 +126,18 @@ curl -fsS -X POST "$CI_API_URL/repos/$CI_PROJECT_PATH/releases" \126
126
127
Het commit moet in de repository bestaan. Het asset moet een artifact zijn van een geslaagde job in dezelfde pipeline. Een beheerder kan met een persoonlijk token een release zonder assets maken. Een tag is `A-Za-z0-9._-`, tot 80 tekens, en wordt ook een annotated git-tag.127
Het commit moet in de repository bestaan. Het asset moet een artifact zijn van een geslaagde job in dezelfde pipeline. Een beheerder kan met een persoonlijk token een release zonder assets maken. Een tag is `A-Za-z0-9._-`, tot 80 tekens, en wordt ook een annotated git-tag.128
128
129
### Eigen release vervangen130
131
Een release bestaat maar één keer: dezelfde tag nog eens publiceren geeft `409`. Een job kan zijn eigen release wel vervangen met `"replace": true` in de body, bijvoorbeeld voor een doorlopende experimentele release. BlueGit verwijdert dan de oude release, de assets en de git-tag en maakt ze opnieuw op het nieuwe commit. Er komt nooit een tweede release met dezelfde tag. Dat mag alleen als al deze regels gelden:132
133
- Het verzoek komt met `CI_JOB_TOKEN` van een lopende job in hetzelfde project. Een persoonlijk token of een job uit een ander project kan niet vervangen (`403` of `401`).134
- De pipeline draait op een branch (`refs/heads/…`) die niet beschermd is. Een beschermde branch zoals `master`, een tag-pipeline en `forks/*` krijgen dit recht nooit (`403`). Een stabiele release vanaf `master` blijft daardoor altijd staan.135
- De tag past niet op een beschermd tagpatroon.136
- De pipeline is veroorzaakt door een maintainer of hoger van het project (de `actor`: wie pushte, mergede of de run startte), of door een instance-admin. Een ontwikkelaar, een onbekende of lege actor krijgt `403`.137
- De bestaande release is door een job gemaakt in een pipeline op dezelfde branch. Een release die met de hand of vanaf een andere ref is gemaakt, blijft staan (`409`).138
139
De assets worden eerst gecontroleerd, pas daarna gaat de oude release weg. Elke vervanging schrijft een regel `release audit` met `action=replace`, repository, tag, oud en nieuw commit, job, pipeline, ref en actor in het serverlog. Zonder `replace` blijft alles zoals het was.140
129
## Wanneer een job start141
## Wanneer een job start130
142
131
`Gate` in `internal/ci` geeft `ready`, `wait`, `skip` of `fail`. `skip` volgt op een harde mislukking bij `when: on_success`, of op succes bij `when: on_failure`. `when: always` wacht tot de voorgangers klaar zijn en draait dan toch. Een job met `allow_failure` telt niet als harde mislukking. De runner verwerkt pipelines elke twee seconden, met `ci.concurrency` tegelijk (standaard 1). Jobs die al lopen vullen die slots. Een startklare job die nog wacht toont `In wachtrij (#n)` in de pipelines-lijst, de stage-popover en op de jobpagina. Het nummer is de plek in Steves globale wachtrij, over alle repositories; de eerstvolgende wachtende job is `#1`.143
`Gate` in `internal/ci` geeft `ready`, `wait`, `skip` of `fail`. `skip` volgt op een harde mislukking bij `when: on_success`, of op succes bij `when: on_failure`. `when: always` wacht tot de voorgangers klaar zijn en draait dan toch. Een job met `allow_failure` telt niet als harde mislukking. De runner verwerkt pipelines elke twee seconden, met `ci.concurrency` tegelijk (standaard 1). Jobs die al lopen vullen die slots. Een startklare job die nog wacht toont `In wachtrij (#n)` in de pipelines-lijst, de stage-popover en op de jobpagina. Het nummer is de plek in Steves globale wachtrij, over alle repositories; de eerstvolgende wachtende job is `#1`.@@ -456,6 +456,10 @@ var en = map[string]string{
456
456
"err.noteEmpty": "a comment is empty",
457
457
"err.mrTitle": "a merge request needs a title",
458
458
"err.tagExists": "tag %s already exists",
459
"err.replaceToken": "only a job token can replace a release",
460
"err.replaceRef": "release replace is only allowed from a pipeline on an unprotected branch of this project (not forks/*)",
461
"err.replaceActor": "release replace needs a pipeline triggered by a maintainer of this project",
462
"err.replaceOrigin": "release %s was not made by a job on this branch and cannot be replaced",
459
463
"err.tagProtected": "tag %s is protected",
460
464
"err.tagMissing": "tag %s does not exist",
461
465
"err.tagRef": "branch or commit %q was not found",
@@ -456,6 +456,10 @@ var en = map[string]string{456
"err.noteEmpty": "a comment is empty",456
"err.noteEmpty": "a comment is empty",457
"err.mrTitle": "a merge request needs a title",457
"err.mrTitle": "a merge request needs a title",458
"err.tagExists": "tag %s already exists",458
"err.tagExists": "tag %s already exists",459
"err.replaceToken": "only a job token can replace a release",460
"err.replaceRef": "release replace is only allowed from a pipeline on an unprotected branch of this project (not forks/*)",461
"err.replaceActor": "release replace needs a pipeline triggered by a maintainer of this project",462
"err.replaceOrigin": "release %s was not made by a job on this branch and cannot be replaced",459
"err.tagProtected": "tag %s is protected",463
"err.tagProtected": "tag %s is protected",460
"err.tagMissing": "tag %s does not exist",464
"err.tagMissing": "tag %s does not exist",461
"err.tagRef": "branch or commit %q was not found",465
"err.tagRef": "branch or commit %q was not found",@@ -455,6 +455,10 @@ var nl = map[string]string{
455
455
"err.noteEmpty": "een reactie is leeg",
456
456
"err.mrTitle": "een merge request heeft een titel nodig",
457
457
"err.tagExists": "tag %s bestaat al",
458
"err.replaceToken": "alleen een job-token kan een release vervangen",
459
"err.replaceRef": "release vervangen mag alleen vanuit een pipeline op een onbeschermde branch van dit project (niet forks/*)",
460
"err.replaceActor": "release vervangen vereist een pipeline die door een maintainer van dit project is gestart",
461
"err.replaceOrigin": "release %s is niet door een job op deze branch gemaakt en kan niet vervangen worden",
458
462
"err.tagProtected": "tag %s is beschermd",
459
463
"err.tagMissing": "tag %s bestaat niet",
460
464
"err.tagRef": "branch of commit %q is niet gevonden",
@@ -1101,6 +1105,10 @@ var de = map[string]string{
1101
1105
"err.noteEmpty": "ein Kommentar ist leer",
1102
1106
"err.mrTitle": "ein Merge Request braucht einen Titel",
1103
1107
"err.tagExists": "Tag %s existiert bereits",
1108
"err.replaceToken": "nur ein Job-Token kann ein Release ersetzen",
1109
"err.replaceRef": "Release ersetzen ist nur aus einer Pipeline auf einem ungeschützten Branch dieses Projekts erlaubt (nicht forks/*)",
1110
"err.replaceActor": "Release ersetzen erfordert eine Pipeline, die von einem Maintainer dieses Projekts ausgelöst wurde",
1111
"err.replaceOrigin": "Release %s wurde nicht von einem Job auf diesem Branch erstellt und kann nicht ersetzt werden",
1104
1112
"err.tagProtected": "Tag %s ist geschützt",
1105
1113
"err.tagMissing": "Tag %s existiert nicht",
1106
1114
"err.tagRef": "Branch oder Commit %q wurde nicht gefunden",
@@ -1747,6 +1755,10 @@ var fr = map[string]string{
1747
1755
"err.noteEmpty": "un commentaire est vide",
1748
1756
"err.mrTitle": "une merge request a besoin d’un titre",
1749
1757
"err.tagExists": "le tag %s existe déjà",
1758
"err.replaceToken": "seul un jeton de job peut remplacer une release",
1759
"err.replaceRef": "le remplacement de release n’est permis que depuis un pipeline sur une branche non protégée de ce projet (pas forks/*)",
1760
"err.replaceActor": "le remplacement de release exige un pipeline déclenché par un mainteneur de ce projet",
1761
"err.replaceOrigin": "la release %s n’a pas été créée par un job sur cette branche et ne peut pas être remplacée",
1750
1762
"err.tagProtected": "le tag %s est protégé",
1751
1763
"err.tagMissing": "le tag %s n’existe pas",
1752
1764
"err.tagRef": "branche ou commit %q est introuvable",
@@ -455,6 +455,10 @@ var nl = map[string]string{455
"err.noteEmpty": "een reactie is leeg",455
"err.noteEmpty": "een reactie is leeg",456
"err.mrTitle": "een merge request heeft een titel nodig",456
"err.mrTitle": "een merge request heeft een titel nodig",457
"err.tagExists": "tag %s bestaat al",457
"err.tagExists": "tag %s bestaat al",458
"err.replaceToken": "alleen een job-token kan een release vervangen",459
"err.replaceRef": "release vervangen mag alleen vanuit een pipeline op een onbeschermde branch van dit project (niet forks/*)",460
"err.replaceActor": "release vervangen vereist een pipeline die door een maintainer van dit project is gestart",461
"err.replaceOrigin": "release %s is niet door een job op deze branch gemaakt en kan niet vervangen worden",458
"err.tagProtected": "tag %s is beschermd",462
"err.tagProtected": "tag %s is beschermd",459
"err.tagMissing": "tag %s bestaat niet",463
"err.tagMissing": "tag %s bestaat niet",460
"err.tagRef": "branch of commit %q is niet gevonden",464
"err.tagRef": "branch of commit %q is niet gevonden",@@ -1101,6 +1105,10 @@ var de = map[string]string{1101
"err.noteEmpty": "ein Kommentar ist leer",1105
"err.noteEmpty": "ein Kommentar ist leer",1102
"err.mrTitle": "ein Merge Request braucht einen Titel",1106
"err.mrTitle": "ein Merge Request braucht einen Titel",1103
"err.tagExists": "Tag %s existiert bereits",1107
"err.tagExists": "Tag %s existiert bereits",1108
"err.replaceToken": "nur ein Job-Token kann ein Release ersetzen",1109
"err.replaceRef": "Release ersetzen ist nur aus einer Pipeline auf einem ungeschützten Branch dieses Projekts erlaubt (nicht forks/*)",1110
"err.replaceActor": "Release ersetzen erfordert eine Pipeline, die von einem Maintainer dieses Projekts ausgelöst wurde",1111
"err.replaceOrigin": "Release %s wurde nicht von einem Job auf diesem Branch erstellt und kann nicht ersetzt werden",1104
"err.tagProtected": "Tag %s ist geschützt",1112
"err.tagProtected": "Tag %s ist geschützt",1105
"err.tagMissing": "Tag %s existiert nicht",1113
"err.tagMissing": "Tag %s existiert nicht",1106
"err.tagRef": "Branch oder Commit %q wurde nicht gefunden",1114
"err.tagRef": "Branch oder Commit %q wurde nicht gefunden",@@ -1747,6 +1755,10 @@ var fr = map[string]string{1747
"err.noteEmpty": "un commentaire est vide",1755
"err.noteEmpty": "un commentaire est vide",1748
"err.mrTitle": "une merge request a besoin d’un titre",1756
"err.mrTitle": "une merge request a besoin d’un titre",1749
"err.tagExists": "le tag %s existe déjà",1757
"err.tagExists": "le tag %s existe déjà",1758
"err.replaceToken": "seul un jeton de job peut remplacer une release",1759
"err.replaceRef": "le remplacement de release n’est permis que depuis un pipeline sur une branche non protégée de ce projet (pas forks/*)",1760
"err.replaceActor": "le remplacement de release exige un pipeline déclenché par un mainteneur de ce projet",1761
"err.replaceOrigin": "la release %s n’a pas été créée par un job sur cette branche et ne peut pas être remplacée",1750
"err.tagProtected": "le tag %s est protégé",1762
"err.tagProtected": "le tag %s est protégé",1751
"err.tagMissing": "le tag %s n’existe pas",1763
"err.tagMissing": "le tag %s n’existe pas",1752
"err.tagRef": "branche ou commit %q est introuvable",1764
"err.tagRef": "branche ou commit %q est introuvable",@@ -20,7 +20,9 @@ type releaseRequest struct {
20
20
Commit string `json:"commit"`
21
21
Name string `json:"name"`
22
22
Body string `json:"body"`
23
Assets []struct {
23
// Replace: een job mag zijn eigen release vervangen (zie checkReplace).
24
Replace bool `json:"replace"`
25
Assets []struct {
24
26
Job string `json:"job"`
25
27
Path string `json:"path"`
26
28
Name string `json:"name"`
@@ -20,7 +20,9 @@ type releaseRequest struct {20
Commit string `json:"commit"`20
Commit string `json:"commit"`21
Name string `json:"name"`21
Name string `json:"name"`22
Body string `json:"body"`22
Body string `json:"body"`23
Assets []struct {23
// Replace: een job mag zijn eigen release vervangen (zie checkReplace).24
Replace bool `json:"replace"`25
Assets []struct {24
Job string `json:"job"`26
Job string `json:"job"`25
Path string `json:"path"`27
Path string `json:"path"`26
Name string `json:"name"`28
Name string `json:"name"`@@ -176,7 +176,7 @@ var apiCatalog = []apiRoute{
176
176
{http.MethodGet, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeRead, authOptional, "Download release asset", (*Server).apiReleaseAsset},
177
177
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}", access.ScopeWrite, authUser, "Delete release (assets included). Query delete_tag=true also deletes the git tag.", (*Server).apiDeleteRelease},
178
178
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeWrite, authUser, "Delete one release asset (tag and source stay)", (*Server).apiDeleteReleaseAsset},
179
{http.MethodPost, "/api/v1/repos/{owner}/{repo}/releases", access.ScopeWrite, authRelease, "Publish release from a job or user token", (*Server).createRelease},
179
{http.MethodPost, "/api/v1/repos/{owner}/{repo}/releases", access.ScopeWrite, authRelease, "Publish release from a job or user token. A job token may send replace=true to replace its own release: running job of this project, pipeline on an unprotected branch (not forks/*), actor maintainer or higher, existing release made by a job on the same branch. Audited.", (*Server).createRelease},
180
180
181
181
{http.MethodGet, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Read instance storage", (*Server).apiAdminStorage},
182
182
{http.MethodPut, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Set instance storage", (*Server).apiAdminStorage},
@@ -176,7 +176,7 @@ var apiCatalog = []apiRoute{176
{http.MethodGet, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeRead, authOptional, "Download release asset", (*Server).apiReleaseAsset},176
{http.MethodGet, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeRead, authOptional, "Download release asset", (*Server).apiReleaseAsset},177
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}", access.ScopeWrite, authUser, "Delete release (assets included). Query delete_tag=true also deletes the git tag.", (*Server).apiDeleteRelease},177
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}", access.ScopeWrite, authUser, "Delete release (assets included). Query delete_tag=true also deletes the git tag.", (*Server).apiDeleteRelease},178
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeWrite, authUser, "Delete one release asset (tag and source stay)", (*Server).apiDeleteReleaseAsset},178
{http.MethodDelete, "/api/v1/projects/{owner}/{repo}/releases/{tag}/assets/{name}", access.ScopeWrite, authUser, "Delete one release asset (tag and source stay)", (*Server).apiDeleteReleaseAsset},179
{http.MethodPost, "/api/v1/repos/{owner}/{repo}/releases", access.ScopeWrite, authRelease, "Publish release from a job or user token", (*Server).createRelease},179
{http.MethodPost, "/api/v1/repos/{owner}/{repo}/releases", access.ScopeWrite, authRelease, "Publish release from a job or user token. A job token may send replace=true to replace its own release: running job of this project, pipeline on an unprotected branch (not forks/*), actor maintainer or higher, existing release made by a job on the same branch. Audited.", (*Server).createRelease},180
180
181
{http.MethodGet, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Read instance storage", (*Server).apiAdminStorage},181
{http.MethodGet, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Read instance storage", (*Server).apiAdminStorage},182
{http.MethodPut, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Set instance storage", (*Server).apiAdminStorage},182
{http.MethodPut, "/api/v1/admin/storage", access.ScopeAdmin, authUser, "Set instance storage", (*Server).apiAdminStorage},@@ -2,7 +2,7 @@ package server
2
2
3
3
import (
4
4
"context"
5
"net/http"
5
"net/http"
6
6
"net/http/httptest"
7
7
"os/exec"
8
8
"path/filepath"
@@ -2,7 +2,7 @@ package server2
2
3
import (3
import (4
"context"4
"context"5
"net/http"5
"net/http"6
"net/http/httptest"6
"net/http/httptest"7
"os/exec"7
"os/exec"8
"path/filepath"8
"path/filepath"@@ -264,8 +264,16 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s
264
264
if !gitrepo.HasCommit(ctx, s.Git, dir, req.Commit) {
265
265
return 0, fail(400, i18n.E("err.commitMissing"))
266
266
}
267
var replace *store.Release
267
268
if gitrepo.HasTag(ctx, s.Git, dir, req.Tag) {
268
return 0, fail(409, i18n.E("err.tagExists", req.Tag))
269
if !req.Replace {
270
return 0, fail(409, i18n.E("err.tagExists", req.Tag))
271
}
272
rel, err := s.checkReplace(ctx, repo, job, req.Tag)
273
if err != nil {
274
return 0, err
275
}
276
replace = &rel
269
277
}
270
278
if req.Name == "" {
271
279
req.Name = req.Tag
@@ -273,7 +281,11 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s
273
281
if job.ID == 0 && len(req.Assets) > 0 {
274
282
return 0, fail(400, i18n.E("err.assetsJob"))
275
283
}
276
var assets []store.ReleaseAsset
284
type srcAsset struct {
285
name, src string
286
size int64
287
}
288
var srcs []srcAsset
277
289
for _, a := range req.Assets {
278
290
if a.Name == "" {
279
291
a.Name = filepath.Base(a.Path)
@@ -289,11 +301,23 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s
289
301
if err != nil {
290
302
return 0, fail(400, i18n.E("err.assetDisk"))
291
303
}
304
srcs = append(srcs, srcAsset{a.Name, src, info.Size()})
305
}
306
// Pas na alle controles: oude release, assets en tag weg.
307
if replace != nil {
308
if err := s.doReplace(ctx, repo, job, *replace, req.Commit); err != nil {
309
return 0, err
310
}
311
}
312
var assets []store.ReleaseAsset
313
for _, sa := range srcs {
314
a := struct{ Name string }{sa.name}
315
src := sa.src
292
316
dst := filepath.Join(s.StoragePath(), "releases", repo.OwnerPath, repo.Name, req.Tag, a.Name)
293
317
if err := copyRelease(src, dst); err != nil {
294
318
return 0, fail(500, i18n.E("err.assetCopy"))
295
319
}
296
assets = append(assets, store.ReleaseAsset{Name: a.Name, StoragePath: dst, Size: info.Size()})
320
assets = append(assets, store.ReleaseAsset{Name: a.Name, StoragePath: dst, Size: sa.size})
297
321
}
298
322
if err := s.postReceive(ctx, repo, author, dir, func() error {
299
323
name, email := gitrepo.FallbackName, gitrepo.FallbackEmail
@@ -264,8 +264,16 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s264
if !gitrepo.HasCommit(ctx, s.Git, dir, req.Commit) {264
if !gitrepo.HasCommit(ctx, s.Git, dir, req.Commit) {265
return 0, fail(400, i18n.E("err.commitMissing"))265
return 0, fail(400, i18n.E("err.commitMissing"))266
}266
}267
var replace *store.Release267
if gitrepo.HasTag(ctx, s.Git, dir, req.Tag) {268
if gitrepo.HasTag(ctx, s.Git, dir, req.Tag) {268
return 0, fail(409, i18n.E("err.tagExists", req.Tag))269
if !req.Replace {270
return 0, fail(409, i18n.E("err.tagExists", req.Tag))271
}272
rel, err := s.checkReplace(ctx, repo, job, req.Tag)273
if err != nil {274
return 0, err275
}276
replace = &rel269
}277
}270
if req.Name == "" {278
if req.Name == "" {271
req.Name = req.Tag279
req.Name = req.Tag@@ -273,7 +281,11 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s273
if job.ID == 0 && len(req.Assets) > 0 {281
if job.ID == 0 && len(req.Assets) > 0 {274
return 0, fail(400, i18n.E("err.assetsJob"))282
return 0, fail(400, i18n.E("err.assetsJob"))275
}283
}276
var assets []store.ReleaseAsset284
type srcAsset struct {285
name, src string286
size int64287
}288
var srcs []srcAsset277
for _, a := range req.Assets {289
for _, a := range req.Assets {278
if a.Name == "" {290
if a.Name == "" {279
a.Name = filepath.Base(a.Path)291
a.Name = filepath.Base(a.Path)@@ -289,11 +301,23 @@ func (s *Server) opPublishRelease(ctx context.Context, repo store.Repo, author s289
if err != nil {301
if err != nil {290
return 0, fail(400, i18n.E("err.assetDisk"))302
return 0, fail(400, i18n.E("err.assetDisk"))291
}303
}304
srcs = append(srcs, srcAsset{a.Name, src, info.Size()})305
}306
// Pas na alle controles: oude release, assets en tag weg.307
if replace != nil {308
if err := s.doReplace(ctx, repo, job, *replace, req.Commit); err != nil {309
return 0, err310
}311
}312
var assets []store.ReleaseAsset313
for _, sa := range srcs {314
a := struct{ Name string }{sa.name}315
src := sa.src292
dst := filepath.Join(s.StoragePath(), "releases", repo.OwnerPath, repo.Name, req.Tag, a.Name)316
dst := filepath.Join(s.StoragePath(), "releases", repo.OwnerPath, repo.Name, req.Tag, a.Name)293
if err := copyRelease(src, dst); err != nil {317
if err := copyRelease(src, dst); err != nil {294
return 0, fail(500, i18n.E("err.assetCopy"))318
return 0, fail(500, i18n.E("err.assetCopy"))295
}319
}296
assets = append(assets, store.ReleaseAsset{Name: a.Name, StoragePath: dst, Size: info.Size()})320
assets = append(assets, store.ReleaseAsset{Name: a.Name, StoragePath: dst, Size: sa.size})297
}321
}298
if err := s.postReceive(ctx, repo, author, dir, func() error {322
if err := s.postReceive(ctx, repo, author, dir, func() error {299
name, email := gitrepo.FallbackName, gitrepo.FallbackEmail323
name, email := gitrepo.FallbackName, gitrepo.FallbackEmail@@ -0,0 +1,103 @@
1
package server
2
3
import (
4
"context"
5
"strings"
6
7
"gitlab.com/Timfa/bluegit/internal/access"
8
"gitlab.com/Timfa/bluegit/internal/ci"
9
"gitlab.com/Timfa/bluegit/internal/gitrepo"
10
"gitlab.com/Timfa/bluegit/internal/i18n"
11
"gitlab.com/Timfa/bluegit/internal/store"
12
)
13
14
// checkReplace: mag deze job de bestaande release met deze tag vervangen?
15
// Alle regels moeten gelden:
16
// - alleen met een job-token (het eigen project is al gecontroleerd);
17
// - de pipeline draait op een branch, niet op forks/*, en die branch is
18
// niet beschermd (master e.d. dus nooit);
19
// - de tag past niet op een beschermd tagpatroon;
20
// - de pipeline is veroorzaakt door (actor) een maintainer of hoger van
21
// het project (of een instance-admin);
22
// - de bestaande release is door een job gemaakt, in een pipeline op
23
// dezelfde branch. Een release met de hand of van een andere ref blijft.
24
func (s *Server) checkReplace(ctx context.Context, repo store.Repo, job store.Job, tag string) (store.Release, error) {
25
if job.ID == 0 {
26
return store.Release{}, fail(403, i18n.E("err.replaceToken"))
27
}
28
p, err := s.Store.PipelineByID(ctx, repo.ID, job.PipelineID)
29
if err != nil {
30
return store.Release{}, fail(403, i18n.E("err.replaceRef"))
31
}
32
if !strings.HasPrefix(p.Ref, "refs/heads/") {
33
return store.Release{}, fail(403, i18n.E("err.replaceRef"))
34
}
35
branch := strings.TrimPrefix(p.Ref, "refs/heads/")
36
if branch == "" || strings.HasPrefix(branch, ci.ForkBranchPrefix) {
37
return store.Release{}, fail(403, i18n.E("err.replaceRef"))
38
}
39
pat, err := s.Store.ProtectedPatterns(ctx, repo.ID)
40
if err != nil || access.BranchProtected(pat, branch) {
41
return store.Release{}, fail(403, i18n.E("err.replaceRef"))
42
}
43
tpat, err := s.Store.ProtectedTagPatterns(ctx, repo.ID)
44
if err != nil || access.BranchProtected(tpat, tag) {
45
return store.Release{}, fail(403, i18n.E("err.tagProtected", tag))
46
}
47
if p.Actor == "" {
48
return store.Release{}, fail(403, i18n.E("err.replaceActor"))
49
}
50
actor, err := s.Store.UserByUsername(ctx, p.Actor)
51
if err != nil || actor.ID == 0 {
52
return store.Release{}, fail(403, i18n.E("err.replaceActor"))
53
}
54
if !actor.InstanceAdmin {
55
role, err := s.Store.EffectiveRole(ctx, actor.ID, repo.ID)
56
if err != nil || !role.AtLeast(access.RoleMaintainer) {
57
return store.Release{}, fail(403, i18n.E("err.replaceActor"))
58
}
59
}
60
rel, err := s.Store.ReleaseByTag(ctx, repo.ID, tag)
61
if err != nil {
62
// Alleen een tag, geen release: niet van een job, dus blijven.
63
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))
64
}
65
jid, err := s.Store.ReleaseJobID(ctx, rel.ID)
66
if err != nil || jid == 0 {
67
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))
68
}
69
oj, err := s.Store.JobByID(ctx, repo.ID, jid)
70
if err != nil {
71
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))
72
}
73
op, err := s.Store.PipelineByID(ctx, repo.ID, oj.PipelineID)
74
if err != nil || op.Ref != p.Ref {
75
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))
76
}
77
return rel, nil
78
}
79
80
// doReplace verwijdert de oude release, assets en tag, met een auditregel.
81
func (s *Server) doReplace(ctx context.Context, repo store.Repo, job store.Job, rel store.Release, newCommit string) error {
82
paths, err := s.Store.DeleteRelease(ctx, rel.ID)
83
if err != nil {
84
return fail(500, err)
85
}
86
for _, p := range paths {
87
s.removeAssetFile(p)
88
}
89
dir := gitrepo.Dir(s.StoragePath(), repo.OwnerPath, repo.Name)
90
if err := gitrepo.DeleteTag(ctx, s.Git, dir, rel.Tag); err != nil {
91
return fail(400, err)
92
}
93
s.refsChanged(repo)
94
actor, ref := "", ""
95
if p, err := s.Store.PipelineByID(ctx, repo.ID, job.PipelineID); err == nil {
96
actor, ref = p.Actor, p.Ref
97
}
98
if s.Log != nil {
99
s.Log.Info("release audit", "action", "replace", "repo", repo.FullPath(), "tag", rel.Tag,
100
"old_commit", rel.CommitSHA, "new_commit", newCommit, "job", job.ID, "pipeline", job.PipelineID, "ref", ref, "actor", actor)
101
}
102
return nil
103
}
@@ -0,0 +1,103 @@1
package server2
3
import (4
"context"5
"strings"6
7
"gitlab.com/Timfa/bluegit/internal/access"8
"gitlab.com/Timfa/bluegit/internal/ci"9
"gitlab.com/Timfa/bluegit/internal/gitrepo"10
"gitlab.com/Timfa/bluegit/internal/i18n"11
"gitlab.com/Timfa/bluegit/internal/store"12
)13
14
// checkReplace: mag deze job de bestaande release met deze tag vervangen?15
// Alle regels moeten gelden:16
// - alleen met een job-token (het eigen project is al gecontroleerd);17
// - de pipeline draait op een branch, niet op forks/*, en die branch is18
// niet beschermd (master e.d. dus nooit);19
// - de tag past niet op een beschermd tagpatroon;20
// - de pipeline is veroorzaakt door (actor) een maintainer of hoger van21
// het project (of een instance-admin);22
// - de bestaande release is door een job gemaakt, in een pipeline op23
// dezelfde branch. Een release met de hand of van een andere ref blijft.24
func (s *Server) checkReplace(ctx context.Context, repo store.Repo, job store.Job, tag string) (store.Release, error) {25
if job.ID == 0 {26
return store.Release{}, fail(403, i18n.E("err.replaceToken"))27
}28
p, err := s.Store.PipelineByID(ctx, repo.ID, job.PipelineID)29
if err != nil {30
return store.Release{}, fail(403, i18n.E("err.replaceRef"))31
}32
if !strings.HasPrefix(p.Ref, "refs/heads/") {33
return store.Release{}, fail(403, i18n.E("err.replaceRef"))34
}35
branch := strings.TrimPrefix(p.Ref, "refs/heads/")36
if branch == "" || strings.HasPrefix(branch, ci.ForkBranchPrefix) {37
return store.Release{}, fail(403, i18n.E("err.replaceRef"))38
}39
pat, err := s.Store.ProtectedPatterns(ctx, repo.ID)40
if err != nil || access.BranchProtected(pat, branch) {41
return store.Release{}, fail(403, i18n.E("err.replaceRef"))42
}43
tpat, err := s.Store.ProtectedTagPatterns(ctx, repo.ID)44
if err != nil || access.BranchProtected(tpat, tag) {45
return store.Release{}, fail(403, i18n.E("err.tagProtected", tag))46
}47
if p.Actor == "" {48
return store.Release{}, fail(403, i18n.E("err.replaceActor"))49
}50
actor, err := s.Store.UserByUsername(ctx, p.Actor)51
if err != nil || actor.ID == 0 {52
return store.Release{}, fail(403, i18n.E("err.replaceActor"))53
}54
if !actor.InstanceAdmin {55
role, err := s.Store.EffectiveRole(ctx, actor.ID, repo.ID)56
if err != nil || !role.AtLeast(access.RoleMaintainer) {57
return store.Release{}, fail(403, i18n.E("err.replaceActor"))58
}59
}60
rel, err := s.Store.ReleaseByTag(ctx, repo.ID, tag)61
if err != nil {62
// Alleen een tag, geen release: niet van een job, dus blijven.63
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))64
}65
jid, err := s.Store.ReleaseJobID(ctx, rel.ID)66
if err != nil || jid == 0 {67
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))68
}69
oj, err := s.Store.JobByID(ctx, repo.ID, jid)70
if err != nil {71
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))72
}73
op, err := s.Store.PipelineByID(ctx, repo.ID, oj.PipelineID)74
if err != nil || op.Ref != p.Ref {75
return store.Release{}, fail(409, i18n.E("err.replaceOrigin", tag))76
}77
return rel, nil78
}79
80
// doReplace verwijdert de oude release, assets en tag, met een auditregel.81
func (s *Server) doReplace(ctx context.Context, repo store.Repo, job store.Job, rel store.Release, newCommit string) error {82
paths, err := s.Store.DeleteRelease(ctx, rel.ID)83
if err != nil {84
return fail(500, err)85
}86
for _, p := range paths {87
s.removeAssetFile(p)88
}89
dir := gitrepo.Dir(s.StoragePath(), repo.OwnerPath, repo.Name)90
if err := gitrepo.DeleteTag(ctx, s.Git, dir, rel.Tag); err != nil {91
return fail(400, err)92
}93
s.refsChanged(repo)94
actor, ref := "", ""95
if p, err := s.Store.PipelineByID(ctx, repo.ID, job.PipelineID); err == nil {96
actor, ref = p.Actor, p.Ref97
}98
if s.Log != nil {99
s.Log.Info("release audit", "action", "replace", "repo", repo.FullPath(), "tag", rel.Tag,100
"old_commit", rel.CommitSHA, "new_commit", newCommit, "job", job.ID, "pipeline", job.PipelineID, "ref", ref, "actor", actor)101
}102
return nil103
}@@ -0,0 +1,121 @@
1
package server
2
3
import (
4
"context"
5
"testing"
6
7
"gitlab.com/Timfa/bluegit/internal/access"
8
"gitlab.com/Timfa/bluegit/internal/store"
9
)
10
11
func TestReleaseReplace(t *testing.T) {
12
e := newCIEnv(t)
13
ctx := context.Background()
14
st, base := e.st, e.ts.URL
15
_ = st.AddProtected(ctx, e.repo.ID, "master")
16
_, _ = st.UpsertUser(ctx, 20, "dev", "", false)
17
_ = st.SetMember(ctx, "repo", e.repo.ID, "dev", access.RoleDeveloper)
18
_, _ = st.UpsertUser(ctx, 21, "mnt", "", false)
19
_ = st.SetMember(ctx, "repo", e.repo.ID, "mnt", access.RoleMaintainer)
20
other, err := st.CreateRepo(ctx, "user", e.user.ID, "other", "", "master", "private")
21
if err != nil {
22
t.Fatal(err)
23
}
24
// jobToken: lopende job in een pipeline op ref met actor.
25
jobToken := func(repoID int64, ref, actor string) string {
26
t.Helper()
27
pid, err := st.CreatePipeline(ctx, repoID, e.sha, ref, "push", actor, "x", []store.NewJob{{Name: "rel", Stage: "deploy", Image: "alpine:3.20", Script: "true"}})
28
if err != nil {
29
t.Fatal(err)
30
}
31
jobs, _ := st.JobsByPipeline(ctx, pid)
32
_, _ = st.QueueJob(ctx, jobs[0].ID)
33
if ok, err := st.MarkJobRunning(ctx, jobs[0].ID); err != nil || !ok {
34
t.Fatalf("running: %v %v", ok, err)
35
}
36
tok, err := st.CreateJobToken(ctx, jobs[0].ID)
37
if err != nil {
38
t.Fatal(err)
39
}
40
return tok
41
}
42
post := func(tok, tag string, replace bool) int {
43
t.Helper()
44
path := "/api/v1/repos/tim/app/releases"
45
if len(tok) > 4 && tok[:4] != "bgj_" {
46
path = "/api/v1/projects/tim/app/releases"
47
}
48
res := postJSON(t, "POST", base+path, tok, map[string]any{"tag": tag, "commit": e.sha, "replace": replace})
49
res.Body.Close()
50
return res.StatusCode
51
}
52
exp := "refs/heads/experimental/x"
53
// Eerste keer: gewoon aanmaken.
54
if c := post(jobToken(e.repo.ID, exp, "tim"), "exp", true); c != 201 {
55
t.Fatalf("create: %d", c)
56
}
57
// Zonder replace: nooit dubbel, 409 zoals voorheen.
58
if c := post(jobToken(e.repo.ID, exp, "tim"), "exp", false); c != 409 {
59
t.Fatalf("no replace: %d", c)
60
}
61
// Eigen project, maintainer-actor, zelfde branch: vervangen.
62
for i, a := range []string{"tim", "mnt"} {
63
if c := post(jobToken(e.repo.ID, exp, a), "exp", true); c != 201 {
64
t.Fatalf("replace %d (%s): %d", i, a, c)
65
}
66
}
67
if rels, _ := st.ListReleases(ctx, e.repo.ID); countTag(rels, "exp") != 1 {
68
t.Fatalf("dubbele release: %d", countTag(rels, "exp"))
69
}
70
// Job-token van een ander project: 401.
71
if c := post(jobToken(other.ID, exp, "tim"), "exp", true); c != 401 {
72
t.Fatalf("other project: %d", c)
73
}
74
// Lagere rol of onbekende actor: 403.
75
for _, a := range []string{"dev", "nobody", ""} {
76
if c := post(jobToken(e.repo.ID, exp, a), "exp", true); c != 403 {
77
t.Fatalf("actor %q: %d", a, c)
78
}
79
}
80
// Fork-pipeline: 403, ook met maintainer-actor.
81
if c := post(jobToken(e.repo.ID, "refs/heads/forks/7/experimental/x", "tim"), "exp", true); c != 403 {
82
t.Fatalf("fork: %d", c)
83
}
84
// Andere branch dan die de release maakte: 409.
85
if c := post(jobToken(e.repo.ID, "refs/heads/other", "tim"), "exp", true); c != 409 {
86
t.Fatalf("other branch: %d", c)
87
}
88
// Stabiele release op beschermde master: nooit vervangen.
89
if c := post(jobToken(e.repo.ID, "refs/heads/master", "tim"), "v1", false); c != 201 {
90
t.Fatalf("master create: %d", c)
91
}
92
if c := post(jobToken(e.repo.ID, "refs/heads/master", "tim"), "v1", true); c != 403 {
93
t.Fatalf("master replace: %d", c)
94
}
95
// Tag-pipeline: 403.
96
if c := post(jobToken(e.repo.ID, "refs/tags/v1", "tim"), "v1", true); c != 403 {
97
t.Fatalf("tag ref: %d", c)
98
}
99
// Met de hand gemaakte release blijft, ook vanaf een open branch.
100
timTok := issue(t, st, e.user.ID, "api")
101
if c := post(timTok, "hand", false); c != 201 {
102
t.Fatalf("hand create: %d", c)
103
}
104
if c := post(jobToken(e.repo.ID, exp, "tim"), "hand", true); c != 409 {
105
t.Fatalf("hand replace: %d", c)
106
}
107
// Persoonlijk token met replace: geen vervangen.
108
if c := post(timTok, "hand", true); c != 403 {
109
t.Fatalf("user replace: %d", c)
110
}
111
}
112
113
func countTag(rels []store.Release, tag string) int {
114
n := 0
115
for _, r := range rels {
116
if r.Tag == tag {
117
n++
118
}
119
}
120
return n
121
}
@@ -0,0 +1,121 @@1
package server2
3
import (4
"context"5
"testing"6
7
"gitlab.com/Timfa/bluegit/internal/access"8
"gitlab.com/Timfa/bluegit/internal/store"9
)10
11
func TestReleaseReplace(t *testing.T) {12
e := newCIEnv(t)13
ctx := context.Background()14
st, base := e.st, e.ts.URL15
_ = st.AddProtected(ctx, e.repo.ID, "master")16
_, _ = st.UpsertUser(ctx, 20, "dev", "", false)17
_ = st.SetMember(ctx, "repo", e.repo.ID, "dev", access.RoleDeveloper)18
_, _ = st.UpsertUser(ctx, 21, "mnt", "", false)19
_ = st.SetMember(ctx, "repo", e.repo.ID, "mnt", access.RoleMaintainer)20
other, err := st.CreateRepo(ctx, "user", e.user.ID, "other", "", "master", "private")21
if err != nil {22
t.Fatal(err)23
}24
// jobToken: lopende job in een pipeline op ref met actor.25
jobToken := func(repoID int64, ref, actor string) string {26
t.Helper()27
pid, err := st.CreatePipeline(ctx, repoID, e.sha, ref, "push", actor, "x", []store.NewJob{{Name: "rel", Stage: "deploy", Image: "alpine:3.20", Script: "true"}})28
if err != nil {29
t.Fatal(err)30
}31
jobs, _ := st.JobsByPipeline(ctx, pid)32
_, _ = st.QueueJob(ctx, jobs[0].ID)33
if ok, err := st.MarkJobRunning(ctx, jobs[0].ID); err != nil || !ok {34
t.Fatalf("running: %v %v", ok, err)35
}36
tok, err := st.CreateJobToken(ctx, jobs[0].ID)37
if err != nil {38
t.Fatal(err)39
}40
return tok41
}42
post := func(tok, tag string, replace bool) int {43
t.Helper()44
path := "/api/v1/repos/tim/app/releases"45
if len(tok) > 4 && tok[:4] != "bgj_" {46
path = "/api/v1/projects/tim/app/releases"47
}48
res := postJSON(t, "POST", base+path, tok, map[string]any{"tag": tag, "commit": e.sha, "replace": replace})49
res.Body.Close()50
return res.StatusCode51
}52
exp := "refs/heads/experimental/x"53
// Eerste keer: gewoon aanmaken.54
if c := post(jobToken(e.repo.ID, exp, "tim"), "exp", true); c != 201 {55
t.Fatalf("create: %d", c)56
}57
// Zonder replace: nooit dubbel, 409 zoals voorheen.58
if c := post(jobToken(e.repo.ID, exp, "tim"), "exp", false); c != 409 {59
t.Fatalf("no replace: %d", c)60
}61
// Eigen project, maintainer-actor, zelfde branch: vervangen.62
for i, a := range []string{"tim", "mnt"} {63
if c := post(jobToken(e.repo.ID, exp, a), "exp", true); c != 201 {64
t.Fatalf("replace %d (%s): %d", i, a, c)65
}66
}67
if rels, _ := st.ListReleases(ctx, e.repo.ID); countTag(rels, "exp") != 1 {68
t.Fatalf("dubbele release: %d", countTag(rels, "exp"))69
}70
// Job-token van een ander project: 401.71
if c := post(jobToken(other.ID, exp, "tim"), "exp", true); c != 401 {72
t.Fatalf("other project: %d", c)73
}74
// Lagere rol of onbekende actor: 403.75
for _, a := range []string{"dev", "nobody", ""} {76
if c := post(jobToken(e.repo.ID, exp, a), "exp", true); c != 403 {77
t.Fatalf("actor %q: %d", a, c)78
}79
}80
// Fork-pipeline: 403, ook met maintainer-actor.81
if c := post(jobToken(e.repo.ID, "refs/heads/forks/7/experimental/x", "tim"), "exp", true); c != 403 {82
t.Fatalf("fork: %d", c)83
}84
// Andere branch dan die de release maakte: 409.85
if c := post(jobToken(e.repo.ID, "refs/heads/other", "tim"), "exp", true); c != 409 {86
t.Fatalf("other branch: %d", c)87
}88
// Stabiele release op beschermde master: nooit vervangen.89
if c := post(jobToken(e.repo.ID, "refs/heads/master", "tim"), "v1", false); c != 201 {90
t.Fatalf("master create: %d", c)91
}92
if c := post(jobToken(e.repo.ID, "refs/heads/master", "tim"), "v1", true); c != 403 {93
t.Fatalf("master replace: %d", c)94
}95
// Tag-pipeline: 403.96
if c := post(jobToken(e.repo.ID, "refs/tags/v1", "tim"), "v1", true); c != 403 {97
t.Fatalf("tag ref: %d", c)98
}99
// Met de hand gemaakte release blijft, ook vanaf een open branch.100
timTok := issue(t, st, e.user.ID, "api")101
if c := post(timTok, "hand", false); c != 201 {102
t.Fatalf("hand create: %d", c)103
}104
if c := post(jobToken(e.repo.ID, exp, "tim"), "hand", true); c != 409 {105
t.Fatalf("hand replace: %d", c)106
}107
// Persoonlijk token met replace: geen vervangen.108
if c := post(timTok, "hand", true); c != 403 {109
t.Fatalf("user replace: %d", c)110
}111
}112
113
func countTag(rels []store.Release, tag string) int {114
n := 0115
for _, r := range rels {116
if r.Tag == tag {117
n++118
}119
}120
return n121
}@@ -1677,3 +1677,13 @@ func manualBlocked(jobs []Job) map[int]bool {
1677
1677
}
1678
1678
}
1679
1679
}
1680
1681
// ReleaseJobID geeft de job die de release maakte (0 = met de hand).
1682
func (s *Store) ReleaseJobID(ctx context.Context, releaseID int64) (int64, error) {
1683
var id sql.NullInt64
1684
err := s.db.QueryRowContext(ctx, `SELECT job_id FROM releases WHERE id = ?`, releaseID).Scan(&id)
1685
if err != nil {
1686
return 0, err
1687
}
1688
return id.Int64, nil
1689
}
@@ -1677,3 +1677,13 @@ func manualBlocked(jobs []Job) map[int]bool {1677
}1677
}1678
}1678
}1679
}1679
}1680
1681
// ReleaseJobID geeft de job die de release maakte (0 = met de hand).1682
func (s *Store) ReleaseJobID(ctx context.Context, releaseID int64) (int64, error) {1683
var id sql.NullInt641684
err := s.db.QueryRowContext(ctx, `SELECT job_id FROM releases WHERE id = ?`, releaseID).Scan(&id)1685
if err != nil {1686
return 0, err1687
}1688
return id.Int64, nil1689
}