File: upload.md

package info (click to toggle)
glab 1.53.0-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 20,936 kB
  • sloc: sh: 295; makefile: 153; perl: 99; ruby: 68; javascript: 67
file content (66 lines) | stat: -rw-r--r-- 2,014 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
---
stage: Create
group: Code Review
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
---

<!--
This documentation is auto generated by a script.
Please do not edit this file directly. Run `make gen-docs` instead.
-->

# `glab release upload`

Upload release asset files or links to a GitLab release.

## Synopsis

Upload release assets to a GitLab release.

Define the display name by appending '#' after the filename.
The link type comes after the display name, like this: 'myfile.tar.gz#My display name#package'

```plaintext
glab release upload <tag> [<files>...] [flags]
```

## Examples

```plaintext
# Upload a release asset with a display name. 'Type' defaults to 'other'.
$ glab release upload v1.0.1 '/path/to/asset.zip#My display label'

# Upload a release asset with a display name and type.
$ glab release upload v1.0.1 '/path/to/asset.png#My display label#image'

# Upload all assets in a specified folder. 'Type' defaults to 'other'.
$ glab release upload v1.0.1 ./dist/*

# Upload all tarballs in a specified folder. 'Type' defaults to 'other'.
$ glab release upload v1.0.1 ./dist/*.tar.gz

# Upload release assets links specified as JSON string
$ glab release upload v1.0.1 --assets-links='
  [
    {
      "name": "Asset1",
      "url":"https://<domain>/some/location/1",
      "link_type": "other",
      "direct_asset_path": "path/to/file"
    }
  ]'

```

## Options

```plaintext
  -a, --assets-links JSON   JSON string representation of assets links, like: `--assets-links='[{"name": "Asset1", "url":"https://<domain>/some/location/1", "link_type": "other", "direct_asset_path": "path/to/file"}]'.`
```

## Options inherited from parent commands

```plaintext
      --help              Show help for this command.
  -R, --repo OWNER/REPO   Select another repository. Can use either OWNER/REPO or `GROUP/NAMESPACE/REPO` format. Also accepts full URL or Git URL.
```