通过 gitea 上传各种 package包

背景

由于之前 nas 上装了 gitea 镜像，在实际应用过程中，因为我主要用的语言是 JavaScript，所以会有很多用到依赖库，但是这个依赖库还没有想好要不要开源。所以想有没有一个办法可以自己搭一个类似Verdaccio 这种私有化部署的开源方案.

最近发现 gitea 集成了这种功能。这可把我乐坏了。以下就是参考官网的一个使用手册发布一个 npm 包的过程。

支持列表

总的来说，它支持的安装包还是很丰富的，我这里只用到了 docker 和 npm 包。所以本文只会对这两个包的发布和下载展开说明。

Name	Language	Package client
Alpine	-	apk
Cargo	Rust	cargo
Chef	-	knife
Composer	PHP	composer
Conan	C++	conan
Conda	-	conda
Container	-	任何符合OCI规范的客户端
CRAN	R	-
Debian	-	apt
Generic	-	任何HTTP客户端
Go	Go	go
Helm	-	任何HTTP客户端, cm-push
Maven	Java	mvn, gradle
npm	JavaScript	npm, yarn, pnpm
NuGet	.NET	nuget
Pub	Dart	dart, flutter
PyPI	Python	pip, twine
RPM	-	yum, dnf, zypper
RubyGems	Ruby	gem, Bundler
Swift	Swift	swift
Vagrant	-	vagrant

npm 注册表

1. 要求

首先需要安装 Node.js 以及与之配套的软件包管理器，例如 Yarn 或 npm 或者 pnpm，我这里使用的是 npm。

该注册表支持作用域（带@前缀）和非作用域软件包。

以下示例使用具有作用域 @jzx/test 的 npm 包。

2. 配置注册表

我这里和官方文档不一样的点是，我发布的验证信息通过 .npmrc 和 package.json 来管理。

首先在项目根目录下创建 .npmrc，并在 .npmrc 中添加以下代码：

//git.jzxer.cn/api/packages/${your username}/npm/:_authToken=${your accessToken}
@jzx:registry=https://git.jzxer.cn/api/packages/devlifestyle/npm/

这段代码的意思是，当你发布包的时候走这个权限校验，这里的accessToken去gitea的个人信息页面申请即可。（记得加上作用域，这里的作用域最好是别和官方npm的冲突）

然后在 package.json 中添加以下代码：

"publishConfig": {
    "registry": "https://git.jzxer.cn/api/packages/${username}/npm/"
  }

username 可以填写你的用户名称，如果是组织下的依赖包则填写组织名称。

这种写法的好处就是不需要像官方的写法一样每次都去填写 npm config set …。

3. 发布依赖

在终端执行 npm publish，如果返回版本信息则表示发布成功。

4. 依赖下载

由于上文中.npmrc中添加了作用域，所以直接 npm i 包名称即可下载成功。

container 注册表

这个是 docker 的镜像包的推送和下载方法。

1. 要求

电脑上有 docker ，并且熟悉 Dockerfile 的基本语法。我这里给一些基本的语法解释说明。

FROM 		#基础镜像，一切从这里开始构建
MAINTAINER	#镜像是谁写的，姓名+邮箱
RUN			#镜像构建时需要运行的命令
ADD			#步骤，tomcat镜像，这个tomcat压缩包；添加内容
WORKDIR		#镜像工作目录
VOLUME		#挂载的目录
EXPOSE		#暴露端口配置
CMD			#指定这个容器启动的时候要运行的命令,只有最后一个会生效，可被替代
ENTRYPOINT	#指定这个容器启动的时候要运行的命令，可以追加命令
ONBUILD		#当构建一个被继承DockerFile 这个时候就会运行 ONBUILD 的指令，触发指令
COPY		#类似ADD,将我们的文件拷贝至镜像中
ENV			#构建的时候设置环境变量

接下来就可以跟着我一起来操作了。

2. 创建 Dockerfile

创建一个文件夹 demo。进入该文件夹中创建一个 Dockerfile 文件，写入以下内容：

FROM ubuntu:18.04

COPY . /app

CMD sh /app/start.sh

3. 添加容器内容

创建一个 start.sh 文件, 写入以下内容：

echo 'Hello World'
#自己再写点其他的也行

4. 登录 docker

需要登录自己的私有docker地址，因为默认的地址是 docker的官方源：

docker login gitea.example.com

按要求输入账号和密码

5. 打包 docker 镜像

这一步是为了按照 Dockerfile 中的内容打包成 docker可识别的镜像，执行：

docker build -t your-image-name:tag .

Your-image-name 是你要打包的包名称，这里建议不要和官方仓库重复，方便以后开源同步推送，tag 是版本号。

6. 给镜像打标签

因为需要推送的是私有仓库，这一步是必要的：

docker tag your-image-name:tag gitea.example.com/${yourname}/your-image-name:tag

7. 推送/下载

推送代码执行如下命令：

docker push gitea.example.com/${yourname}/your-image-name:tag

下载镜像执行以下命令：

docker pull gitea.example.com/${yourname}/your-image-name:tag

8. 保存到当前文件夹（可选）

如果有额外需求，比如说当前的电脑无法联网，可以尝试下载到本地，然后再执行部署。

docker save -o your-image-name.tar your-image-name:tag

用本地文件部署

docker load -i your--local-image-name.tar

小结

以上就是使用 gitea 的软件包模块的完整流程。其它的软件包也是同理，可以去参考 gitea 的官方文档。

总的来说难度不高，下一期尝试一下把部署的流程通过 gitea-runner 实现自动化发布。这样就不用每次都手动去发布了。

参考

gitea

dev的艺术空间