跳到主要内容
版本:1.21-dev

Vagrant 软件包注册表

为您的用户或组织发布 Vagrant 软件包。

要求

要使用 Vagrant 软件包注册表,您需要安装 Vagrant 并使用类似于 curl 的工具进行 HTTP 请求。

发布软件包

通过执行 HTTP PUT 请求将 Vagrant box 发布到注册表:

PUT https://gitea.example.com/api/packages/{owner}/vagrant/{package_name}/{package_version}/{provider}.box
参数描述
owner软件包的所有者
package_name软件包的名称
package_version软件包的版本,兼容 semver 格式
provider支持的提供程序名称之一

上传 Hyper-V box 的示例:

curl --user your_username:your_password_or_token \
--upload-file path/to/your/vagrant.box \
https://gitea.example.com/api/packages/testuser/vagrant/test_system/1.0.0/hyperv.box

如果已经存在相同名称、版本和提供程序的软件包,则无法发布软件包。您必须首先删除现有的软件包。

安装软件包

要从软件包注册表安装软件包,请执行以下命令:

vagrant box add "https://gitea.example.com/api/packages/{owner}/vagrant/{package_name}"
参数描述
owner软件包的所有者.
package_name软件包的名称

例如:

vagrant box add "https://gitea.example.com/api/packages/testuser/vagrant/test_system"

这将安装软件包的最新版本。要添加特定版本,请使用 --box-version 参数。 如果注册表是私有的,您可以将您的个人访问令牌传递给 VAGRANT_CLOUD_TOKEN 环境变量。

支持的命令

vagrant box add
An icon showing wave propagation

Join our community

Gitea is open source. Star our GitHub repo, and join our community on Discord!

An icon showing a paper plane

Subscribe to our newsletter

Stay up to date with all things Gitea