开源项目Git-Deliver详解及新手指南

开源项目Git-Deliver详解及新手指南

git-deliver Delivery system based on git push and ssh 项目地址: https://gitcode.com/gh_mirrors/gi/git-deliver

项目基础介绍

Git-Deliver 是一个基于GPLv3许可的开源交付系统，它创新性地利用了git push命令结合SSH来安全、简便地将项目（特定的Git提交）部署到不同的环境（Git远程仓库）。此工具通过一系列阶段化处理加强了交付过程的结构化，确保原子性操作，并且能够追踪记录每一次部署到哪个服务器，支持版本归档和自动回滚功能。此外，Git-Deliver设计用于提供通用开发环境的预配置交付方案，简化了复杂度。

主要编程语言

• 核心脚本: 主要是使用Bash脚本编写，适用于Linux和macOS环境。对于Windows用户，在配置好SSH并解决了执行权限等问题后也能顺利使用。
• 配置与扩展: 可能涉及一些简单的配置文件编辑，不直接关联特定编程语言，但了解基本的Git操作和Shell脚本对使用非常有帮助。

新手使用注意事项及解决方案

注意事项 1: 安装与Git配置

问题描述: 用户可能遇到在Git配置中添加自定义git-deliver别名时的权限错误。

解决步骤:

1. 克隆仓库: 在本地合适位置克隆Git-Deliver仓库。
2. 修改Git配置: 进入.gitconfig文件，添加以下行至[alias]部分：

   deliver = "bash <路径>/git-deliver/deliver.sh"
   

   其中 <路径> 应替换为实际的Git-Deliver仓库路径。
3. 避免路径冲突: 确保没有其他不可执行的“git-deliver”文件存在于PATH环境变量指定的目录中，以免Git误识别。

注意事项 2: SSH密钥配置

问题描述: 在Windows或其他操作系统上初次使用时，频繁输入SSH密码可能会成为困扰。

解决步骤:

1. 生成SSH密钥对: 使用ssh-keygen命令在本地生成SSH公钥和私钥。
2. 添加公钥到远程: 将生成的公钥(id_rsa.pub)的内容复制到目标服务器或GitHub等Git托管服务的SSH设置中。
3. 验证连接: 测试SSH连接是否能无密码访问远程仓库，使用命令 ssh -T git@<remote_host>。

注意事项 3: 使用原子交付时的版本切换

问题描述: 初次尝试原子式交付时，用户可能不太清楚如何正确进行版本切换以保持服务连续性。

解决步骤:

1. 理解交付流程: 交付新版本前，需确保deliver.sh脚本中的阶段化脚本已正确配置。
2. 执行交付命令: 使用git deliver开始交付过程，该命令会按照阶段顺序执行脚本，最后更新指向当前版本的符号链接。
3. 测试与验证: 在生产环境中，推荐先在测试环境进行全面测试，确保交付流程无误后，再进行生产环境的部署。

以上是 Git-Deliver 的基本介绍及其使用过程中新手需要注意的几个关键点，遵循这些指导，可以有效避免常见的陷阱，确保项目的顺利部署和管理。

git-deliver Delivery system based on git push and ssh 项目地址: https://gitcode.com/gh_mirrors/gi/git-deliver