发布 KCL 包到 ghcr.io

kpm 是一个用于管理 kcl 包的工具。本文将指导您如何使用 kpm 将您的 kcl 包推送到发布到 OCI Registry 中。kpm 默认使用 ghcr.io 作为 OCI Registry, 您可以通过修改 kpm 配置文件来更改默认的 OCI Registry。关于如何修改 kpm 配置文件的信息，请参阅 kpm oci registry

下面是一个简单的步骤，指导您如何使用 kpm 将您的 kcl 包推送到 ghcr.io。

步骤 1：安装 kpm

首先，您需要在您的计算机上安装 kpm。您可以按照 kpm 安装文档中的说明进行操作。

步骤 2：创建一个 ghcr.io 令牌

如果您使用 kpm 默认的 OCI Registry, 要将 kcl 包推送到 ghcr.io，您需要创建一个用于身份验证的令牌。您可以参考以下文档。

• 创建 ghcr.io token

步骤 3：登录 ghcr.io

在安装了 kpm 并创建了 ghcr.io 令牌后，您需要使用 kpm 登录 ghcr.io。您可以使用以下命令进行操作：

kpm login -u <USERNAME> -p <TOKEN> ghcr.io

其中 <USERNAME> 是您的 GitHub 用户名，<TOKEN> 是您在步骤 2 中创建的令牌。

关于如何使用 kpm 登录 ghcr.io 的更多信息，请参阅 kpm login。

步骤 4：推送您的 kcl 包

现在，您可以使用 kpm 将您的 kcl 包推送到 ghcr.io。

1. 一个合法的 kcl 包

首先，您需要确保您推送的内容是符合一个 kcl 包的规范，即必须包含合法的 kcl.mod 和 kcl.mod.lock 文件。

如果您不知道如何得到一个合法的 kcl.mod 和 kcl.mod.lock。您可以使用 kpm init 命令。

# 创建一个名为 my_package 的 kcl 包
kpm init my_package

kpm init my_package 命令将会为您创建一个新的 kcl 包 my_package, 并为这个包创建 kcl.mod 和 kcl.mod.lock 文件。

如果您已经有了一个包含 kcl 文件的目录 exist_kcl_package，您可以使用以下命令将其转换为一个 kcl 包，并为其创建合法的 kcl.mod 和 kcl.mod.lock。

# 在 exist_kcl_package 目录下
$ pwd 
/home/user/exist_kcl_package

# 执行 kpm init 命令来创建 kcl.mod 和 kcl.mod.lock
$ kpm init 

关于如何使用 kpm init 的更多信息，请参阅 kpm init。

2. 推送 kcl 包

您可以在 kcl 包的根目录下使用以下命令进行操作：

# 在 exist_kcl_package 包的根目录下
$ pwd 
/home/user/exist_kcl_package

# 推送 kcl 包到默认的 OCI Registry
$ kpm push

完成上述步骤后，您就成功地将您的 kcl 包推送到了默认的 OCI Registry 中。 关于如何使用 kpm push 的更多信息，请参阅 kpm push。