Go to file
徐晓伟 c5b69a4005 📝 增加 help 说明 2023-10-09 12:57:07 +08:00
.gitlab 👷 add dependabot.yml 2023-10-05 05:30:31 +08:00
access_requests 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
boards 使用 log 替换 fmt 2023-10-09 12:51:18 +08:00
buildinfo ⬆️ github.com/xuxiaowei-com-cn/git-go 2023-10-08 11:35:56 +08:00
constant 🚧 删除无用常量 2023-10-05 02:28:26 +08:00
docker 👷 build docker 2023-10-05 21:25:52 +08:00
flag 实例级 CI/CD 变量 API: 列出所有实例变量 2023-10-08 12:35:46 +08:00
instance_level_ci_variables 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
job_artifacts 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
jobs 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
pipelines 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
projects 使用 log 替换 fmt 2023-10-09 10:18:31 +08:00
static 📝 项目介绍 2023-10-05 04:36:40 +08:00
utils 🚧 删除项目产物 2023-10-05 03:13:04 +08:00
.gitignore 🚧 打包产物携带版本相关信息 2023-10-02 04:06:40 +08:00
.gitlab-ci.yml 👷 test、run 2023-10-09 01:16:19 +08:00
CHANGELOG 🔊 add CHANGELOG 2023-10-05 05:57:43 +08:00
CONTRIBUTING.md 👥 Add CONTRIBUTING 2023-10-05 05:58:40 +08:00
LICENSE add LICENSE. 2023-10-04 20:29:14 +00:00
README.md 📝 增加 help 说明 2023-10-09 12:57:07 +08:00
gitmoji.md 🎉 init 2023-10-01 21:40:53 +08:00
go.mod ⬆️ github.com/xanzy/go-gitlab 2023-10-08 11:27:49 +08:00
go.sum ⬆️ github.com/xanzy/go-gitlab 2023-10-08 11:27:49 +08:00
main.go 使用 log 替换 fmt 2023-10-09 12:51:18 +08:00
main_test.go 添加 projects 测试 2023-10-04 22:29:47 +08:00
sync.yml 👷 add sync 2023-10-01 21:43:52 +08:00

README.md

gitlab-go

GitLab Go 脚手架

License-Anti Link-996 QQ群

基于 go 语言的 gitlab 脚手架

为简化开发工作、提高生产率、解决常见问题而生

开发命令

get

go env -w GOPROXY=https://goproxy.cn,direct
# go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/
go get -u github.com/urfave/cli/v2
go get -u github.com/xanzy/go-gitlab
go get -u github.com/xuxiaowei-com-cn/git-go@main
go get -u gopkg.in/yaml.v3

mod

go mod tidy
go mod download

run

go run main.go

run help

  • Windows 环境为 %xxx%
  • Linux 环境为 $xxx
go run main.go help
$ go run main.go --help
NAME:
   gitlab-go - 基于 Go 语言开发的 GitLab 命令行工具

USAGE:
   gitlab-go [global options] command [command options] [arguments...]

VERSION:
   dev

AUTHOR:
   徐晓伟 <xuxiaowei@xuxiaowei.com.cn>

COMMANDS:
   access-request, access-requests, ar                            群组和项目访问请求 API中文文档https://docs.gitlab.cn/jh/api/access_requests.html
   board, boards                                                  项目议题板 API中文文档https://docs.gitlab.cn/jh/api/boards.html
   instance-level-ci-variable, instance-level-ci-variables, ilcv  实例级 CI/CD 变量 API中文文档https://docs.gitlab.cn/jh/api/instance_level_ci_variables.html
   job-artifact, job-artifacts, ja                                作业产物 API中文文档https://docs.gitlab.cn/jh/api/job_artifacts.html
   job, jobs, j                                                   作业 API中文文档https://docs.gitlab.cn/jh/api/jobs.html
   pipeline, pipelines, pl                                        流水线 API中文文档https://docs.gitlab.cn/jh/api/pipelines.html
   project, projects, p                                           项目 API中文文档https://docs.gitlab.cn/jh/api/projects.html
   help, h                                                        Shows a list of commands or help for one command

GLOBAL OPTIONS:
   --help, -h     show help
   --version, -v  print the version

COPYRIGHT:
   徐晓伟工作室 <xuxiaowei@xuxiaowei.com.cn>
  • access-request - 群组和项目访问请求 API

    $ go run main.go access-request --help
    NAME:
       gitlab-go access-request - 群组和项目访问请求 API中文文档https://docs.gitlab.cn/jh/api/access_requests.html
    
    USAGE:
       gitlab-go access-request command [command options] [arguments...]
    
    COMMANDS:
       group, groups      为群组列出访问请求
       project, projects  为项目列出访问请求
       help, h            Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --id value        项目 ID 或 URL 编码的路径
       --help, -h        show help
    
  • board - 项目议题板 API

    $ go run main.go board --help
    NAME:
       gitlab-go board - 项目议题板 API中文文档https://docs.gitlab.cn/jh/api/boards.html
    
    USAGE:
       gitlab-go board command [command options] [arguments...]
    
    COMMANDS:
       list     列出项目议题板
       help, h  Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --id value        项目 ID 或 URL 编码的路径
       --help, -h        show help
    
  • instance-level-ci-variable - 实例级 CI/CD 变量 API

    $ go run main.go instance-level-ci-variable --help
    NAME:
       gitlab-go instance-level-ci-variable - 实例级 CI/CD 变量 API中文文档https://docs.gitlab.cn/jh/api/instance_level_ci_variables.html
    
    USAGE:
       gitlab-go instance-level-ci-variable command [command options] [arguments...]
    
    COMMANDS:
       get      列出所有实例变量
       help, h  Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --help, -h        show help
    
  • job-artifact - 作业产物 API

    $ go run main.go job-artifact --help
    NAME:
       gitlab-go job-artifact - 作业产物 API中文文档https://docs.gitlab.cn/jh/api/job_artifacts.html
    
    USAGE:
       gitlab-go job-artifact command [command options] [arguments...]
    
    COMMANDS:
       get                                    获取作业产物(未完成)
       download, dl                           下载产物归档文件(未完成)
       delete, rm                             删除作业产物
       delete-project, delete-projects, rm-p  删除项目产物
       help, h                                Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --id value        项目 ID 或 URL 编码的路径
       --job-id value    作业 ID
       --help, -h        show help
    
  • job - 作业 API

    $ go run main.go job --help
    NAME:
       gitlab-go job - 作业 API中文文档https://docs.gitlab.cn/jh/api/jobs.html
    
    USAGE:
       gitlab-go job command [command options] [arguments...]
    
    COMMANDS:
       list     列出项目作业
       help, h  Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --sort value      按照 asc 或者 desc 排序 (default: "desc")
       --help, -h        show help
    
  • pipeline - 流水线 API

    $ go run main.go pipeline --help
    NAME:
       gitlab-go pipeline - 流水线 API中文文档https://docs.gitlab.cn/jh/api/pipelines.html
    
    USAGE:
       gitlab-go pipeline command [command options] [arguments...]
    
    COMMANDS:
       list     列出项目流水线
       help, h  Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --sort value      按照 asc 或者 desc 排序 (default: "desc")
       --id value        项目 ID 或 URL 编码的路径
       --help, -h        show help
    
  • project - 项目 API

    $ go run main.go project --help
    NAME:
       gitlab-go project - 项目 API中文文档https://docs.gitlab.cn/jh/api/projects.html
    
    USAGE:
       gitlab-go project command [command options] [arguments...]
    
    COMMANDS:
       list     列出所有项目
       help, h  Shows a list of commands or help for one command
    
    OPTIONS:
       --base-url value  实例地址例如https://gitlab.xuxiaowei.com.cn/api/v4 (default: "https://gitlab.com/api/v4") [%CI_API_V4_URL%]
       --token value     your_access_token
       --sort value      按照 asc 或者 desc 排序 (default: "desc")
       --help, -h        show help
    

test

go test ./... -v

build

go build
# GOOS=设置构建的目标操作系统darwin | freebsd | linux | windows
# GOARCH=设置构建的目标操作系统386 | amd64 | arm | arm64
# -v打印编译过程中的详细信息
# -ldflags设置在编译时传递给链接器的参数
# -ldflags "-s -w -buildid="
#                           -s: 删除符号表信息,减小可执行文件的大小。
#                           -w: 删除调试信息,使可执行文件在运行时不会打印调试信息。
#                           -buildid=: 删除构建ID使可执行文件在运行时不会打印构建ID。
# -trimpath去掉所有包含 go path 的路径
# -o指定构建后输出的文件名
  • Windows

    • amd64
      go build -o buildinfo/buildinfo.exe buildinfo/buildinfo.go
      GOOS=windows GOARCH=amd64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo.exe now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo.exe commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo.exe commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo.exe commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo.exe commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo.exe commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo.exe commitTag) -X main.GoVersion=$(buildinfo/buildinfo.exe goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=windows/amd64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-windows-amd64.exe .
      
    • arm64
      go build -o buildinfo/buildinfo.exe buildinfo/buildinfo.go
      GOOS=windows GOARCH=arm64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo.exe now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo.exe commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo.exe commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo.exe commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo.exe commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo.exe commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo.exe commitTag) -X main.GoVersion=$(buildinfo/buildinfo.exe goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=windows/arm64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-windows-arm64.exe .
      
  • Linux

    • amd64
      go build -o buildinfo/buildinfo buildinfo/buildinfo.go
      GOOS=linux GOARCH=amd64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo commitTag) -X main.GoVersion=$(buildinfo/buildinfo goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=linux/amd64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-linux-amd64 .
      
    • arm64
      go build -o buildinfo/buildinfo buildinfo/buildinfo.go
      GOOS=linux GOARCH=arm64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo commitTag) -X main.GoVersion=$(buildinfo/buildinfo goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=linux/arm64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-linux-arm64 .
      
  • Darwin

    • amd64
      go build -o buildinfo/buildinfo buildinfo/buildinfo.go
      GOOS=darwin GOARCH=amd64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo commitTag) -X main.GoVersion=$(buildinfo/buildinfo goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=darwin/amd64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-darwin-amd64 .
      
    • arm64
      go build -o buildinfo/buildinfo buildinfo/buildinfo.go
      GOOS=darwin GOARCH=arm64 go build -v -ldflags "-s -w -buildid= -X main.BuildDate=$(buildinfo/buildinfo now) -X main.Compiler= -X main.GitCommitBranch=$(buildinfo/buildinfo commitBranch) -X main.GitCommitSha=$(buildinfo/buildinfo commitSha) -X main.GitCommitShortSha=$(buildinfo/buildinfo commitShortSha) -X main.GitCommitTag=$(buildinfo/buildinfo commitTag) -X main.GitCommitTimestamp=$(buildinfo/buildinfo commitTimestamp) -X main.GitTreeState= -X main.GitVersion=$(buildinfo/buildinfo commitTag) -X main.GoVersion=$(buildinfo/buildinfo goShortVersion) -X main.Major= -X main.Minor= -X main.Revision= -X main.Platform=darwin/arm64 -X main.CiPipelineId= -X main.CiJobId=" -trimpath -o gitlab-go-darwin-arm64 .