93 lines
2.1 KiB
Markdown
93 lines
2.1 KiB
Markdown
sc3dev-packager(1) "@PROJECT_VERSION@"
|
|
|
|
# NAME
|
|
|
|
sc3dev-packager - interact with Gitea package repos
|
|
|
|
# SYNOPSIS
|
|
|
|
sc3dev-packager [flags] repo command package-names...
|
|
|
|
# DESCRIPTION
|
|
|
|
sc3dev-packager is a tool for uploading and deleting packages from
|
|
Gitea servers.
|
|
|
|
Flags:
|
|
|
|
*--component component*
|
|
Select the package component (Debian-only). Defaults to 'main'.
|
|
|
|
*--config path*
|
|
The path to a simple config file that should be used.
|
|
|
|
*--distribution distribution*
|
|
Select the package distribution (Debian-only). Defaults to 'ubuntu'.
|
|
|
|
*--owner owner*
|
|
Select the owner of the package repository. Defaults to 'sc'.
|
|
|
|
*--verbose*
|
|
Show verbose cURL output.
|
|
|
|
Repositories:
|
|
|
|
The supported repositories are:
|
|
|
|
- debian
|
|
- generic
|
|
|
|
Commands:
|
|
|
|
- del removes the package from the repository. Deleted packages don't
|
|
have to exist on disk.
|
|
- put uploads the package to the repository.
|
|
|
|
# EXAMPLES
|
|
|
|
*sc3dev-packager --owner joe debian put /path/to/package_1.0.0_amd64.deb*
|
|
Upload package_1.0.0_amd64.deb to the Debian package repository
|
|
owned by 'joe'.
|
|
|
|
*sc3dev-packager --owner bob generic del package-1.0.0-Linux-x86_64.tar.gz.sh*
|
|
Remove package-1.0.0-Linux-x86_64.tar.gz from the generic package
|
|
repository owned by 'bob'.
|
|
|
|
# Configuration
|
|
|
|
This uses an SCSL simple configuration to gather data. Valid variables
|
|
that can be configured:
|
|
|
|
- component
|
|
- distribution
|
|
- http_user: the user name to authenticate as
|
|
- http_pass: the password to authenticate with
|
|
- owner
|
|
- server: no protocol information, only the hostname (and optionally port).
|
|
- verbose: if not set from the commandline, it should be the string "true".
|
|
|
|
Example configuration:
|
|
|
|
```
|
|
owner = someorg
|
|
http_user = joe
|
|
http_pass = correct horse battery staple
|
|
server = git.example.com
|
|
```
|
|
|
|
Alternatively, any of these variables may be set on the command line:
|
|
|
|
```
|
|
owner=joe sc3dev-packager debian put newpkg_1.0.1_arm64.deb
|
|
```
|
|
|
|
# FILES
|
|
|
|
*/etc/sc3dev/packager.conf*
|
|
The default configuration file path if run as root.
|
|
*$HOME/.config/sc3dev-packager.conf*
|
|
The default configuration path if run as a user.
|
|
|
|
# SEE ALSO
|
|
|
|
The project's homepage is on [Gitea](https://git.wntrmute.dev/sc/sc3dev). |