-
-
Notifications
You must be signed in to change notification settings - Fork 5.8k
Add RPM registry #23380
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
Merged
Add RPM registry #23380
Changes from all commits
Commits
Show all changes
20 commits
Select commit
Hold shift + click to select a range
17bea08
Add RPM registry.
KN4CK3R 1b0504b
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R b5ac9ee
Fix CI.
KN4CK3R 16ae542
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 42d6e49
lint
KN4CK3R 2ca4caf
tidy
KN4CK3R 57dab0f
Mention token in documentation.
KN4CK3R 747ae79
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 0782f8a
Use relative url.
KN4CK3R 7710ac2
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 060650d
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 99dbc4e
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R d66c9d8
Unify with Debian code.
KN4CK3R 68d0056
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 225cf1d
Merge branch 'main' of https://github.com/go-gitea/gitea into feature…
KN4CK3R 4c7c43e
make svg
KN4CK3R 5e95e2b
make tidy
KN4CK3R 28df9d2
resolve links in docs
techknowlogick f646fe7
Merge branch 'main' into feature-rpm
GiteaBot 33e4fa6
Merge branch 'main' into feature-rpm
GiteaBot File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,118 @@ | ||
| --- | ||
| date: "2023-03-08T00:00:00+00:00" | ||
| title: "RPM Packages Repository" | ||
| slug: "packages/rpm" | ||
| draft: false | ||
| toc: false | ||
| menu: | ||
| sidebar: | ||
| parent: "packages" | ||
| name: "RPM" | ||
| weight: 105 | ||
| identifier: "rpm" | ||
| --- | ||
|
|
||
| # RPM Packages Repository | ||
|
|
||
| Publish [RPM](https://rpm.org/) packages for your user or organization. | ||
|
|
||
| **Table of Contents** | ||
|
|
||
| {{< toc >}} | ||
|
|
||
| ## Requirements | ||
|
|
||
| To work with the RPM registry, you need to use a package manager like `yum` or `dnf` to consume packages. | ||
|
|
||
| The following examples use `dnf`. | ||
|
|
||
| ## Configuring the package registry | ||
|
|
||
| To register the RPM registry add the url to the list of known apt sources: | ||
|
|
||
| ```shell | ||
| dnf config-manager --add-repo https://gitea.example.com/api/packages/{owner}/rpm.repo | ||
| ``` | ||
|
|
||
| | Placeholder | Description | | ||
| | ----------- | ----------- | | ||
| | `owner` | The owner of the package. | | ||
|
|
||
| If the registry is private, provide credentials in the url. You can use a password or a [personal access token]({{< relref "doc/developers/api-usage.en-us.md#authentication" >}}): | ||
|
|
||
| ```shell | ||
| dnf config-manager --add-repo https://{username}:{your_password_or_token}@gitea.example.com/api/packages/{owner}/rpm.repo | ||
| ``` | ||
|
|
||
| You have to add the credentials to the urls in the `rpm.repo` file in `/etc/yum.repos.d` too. | ||
|
|
||
| ## Publish a package | ||
|
|
||
| To publish a RPM package (`*.rpm`), perform a HTTP PUT operation with the package content in the request body. | ||
|
|
||
| ``` | ||
| PUT https://gitea.example.com/api/packages/{owner}/rpm/upload | ||
| ``` | ||
|
|
||
| | Parameter | Description | | ||
| | --------- | ----------- | | ||
| | `owner` | The owner of the package. | | ||
|
|
||
| Example request using HTTP Basic authentication: | ||
|
|
||
| ```shell | ||
| curl --user your_username:your_password_or_token \ | ||
| --upload-file path/to/file.rpm \ | ||
| https://gitea.example.com/api/packages/testuser/rpm/upload | ||
| ``` | ||
|
|
||
| If you are using 2FA or OAuth use a [personal access token]({{< relref "doc/developers/api-usage.en-us.md#authentication" >}}) instead of the password. | ||
| You cannot publish a file with the same name twice to a package. You must delete the existing package version first. | ||
|
|
||
| The server reponds with the following HTTP Status codes. | ||
|
|
||
| | HTTP Status Code | Meaning | | ||
| | ----------------- | ------- | | ||
| | `201 Created` | The package has been published. | | ||
| | `400 Bad Request` | The package is invalid. | | ||
| | `409 Conflict` | A package file with the same combination of parameters exist already in the package. | | ||
|
|
||
| ## Delete a package | ||
|
|
||
| To delete a Debian package perform a HTTP DELETE operation. This will delete the package version too if there is no file left. | ||
|
|
||
| ``` | ||
| DELETE https://gitea.example.com/api/packages/{owner}/rpm/{package_name}/{package_version}/{architecture} | ||
| ``` | ||
|
|
||
| | Parameter | Description | | ||
| | ----------------- | ----------- | | ||
| | `owner` | The owner of the package. | | ||
| | `package_name` | The package name. | | ||
| | `package_version` | The package version. | | ||
| | `architecture` | The package architecture. | | ||
|
|
||
| Example request using HTTP Basic authentication: | ||
|
|
||
| ```shell | ||
| curl --user your_username:your_token_or_password -X DELETE \ | ||
| https://gitea.example.com/api/packages/testuser/rpm/test-package/1.0.0/x86_64 | ||
| ``` | ||
|
|
||
| The server reponds with the following HTTP Status codes. | ||
|
|
||
| | HTTP Status Code | Meaning | | ||
| | ----------------- | ------- | | ||
| | `204 No Content` | Success | | ||
| | `404 Not Found` | The package or file was not found. | | ||
|
|
||
| ## Install a package | ||
|
|
||
| To install a package from the RPM registry, execute the following commands: | ||
|
|
||
| ```shell | ||
| # use latest version | ||
| dnf install {package_name} | ||
| # use specific version | ||
| dnf install {package_name}-{package_version}.{architecture} | ||
| ``` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.