Vagrant 套件註冊表
為您的用戶或組織發布 Vagrant 套件。
需求
要使用 Vagrant 套件註冊表，您需要 Vagrant 和一個用於發送 HTTP 請求的工具，如 curl。
發布套件
通過執行 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
如果您使用 2FA 或 OAuth，請使用 個人訪問令牌 代替密碼。
如果已經存在同名、同版本和同提供者的 box，您不能發布該 box。您必須先刪除現有的套件。
服務器響應以下 HTTP 狀態碼。
| HTTP 狀態碼 | 含義 |
|---|---|
201 Created | 套件已發布。 |
400 Bad Request | 套件無效。 |
409 Conflict | 套件中已存在具有相同參數組合的文件。 |
安裝套件
要從套件註冊表中安裝 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