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