Vagrant 包仓库

发布 Vagrant 包到您的用户或组织中。

要求

要使用 Vagrant 包仓库，您需要 Vagrant 和一个用于发出 HTTP 请求的工具，例如 curl。

发布包

通过向仓库发出 HTTP PUT 请求来发布 Vagrant 盒子。

PUT https://gitea.example.com/api/packages/{owner}/vagrant/{package_name}/{package_version}/{provider}.box

参数	描述
owner	包的所有者。
package_name	包名称。
package_version	包版本，兼容 semver。
provider	一个 受支持的提供商名称。

上传 Hyper-V 盒子的示例

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

如果您使用的是 2FA 或 OAuth，请使用 个人访问令牌 而不是密码。

如果您已经存在同名、同版本和同提供商的盒子，则无法发布该盒子。您必须先删除现有的包。

服务器将以以下 HTTP 状态码进行响应。

HTTP 状态码	含义
201 已创建	包已发布。
400 错误请求	包无效。
409 冲突	具有相同参数组合的包已存在。

安装包

要从包仓库安装盒子，请执行以下命令

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