docs/i18n/zh-tw/docusaurus-plugin-content-docs/version-1.23/usage/packages/vagrant.md

date, slug, sidebar_position

date	slug	sidebar_position
2022-08-23T00:00:00+00:00	vagrant	120

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