# 使用 GitHub 的 Deploy Key 进行项目部署

在现代软件开发中，自动化部署已成为保障项目高效上线的关键环节。GitHub 的 Deploy Key 提供了一种安全、简便的方式，使服务器能够安全地访问 GitHub 仓库，从而实现代码的自动部署。本篇博客将详细介绍如何使用 GitHub 的 Deploy Key 进行项目部署，涵盖其概念、对比分析、准备工作以及具体实施步骤。

## 目录

1. [Deploy Key 介绍](#deploy-key-介绍)
2. [相似方案对比，优缺点整理](#相似方案对比优缺点整理)
3. [服务器所需准备](#服务器所需准备)
4. [GitHub 所需准备](#github-所需准备)
5. [详细的实践指南](#详细的实践指南)
6. [总结](#总结)





## Deploy Key 介绍

**Deploy Key** 是 GitHub 提供的一种 SSH 公钥，用于授权服务器访问特定的 GitHub 仓库。与个人 SSH 密钥不同，Deploy Key 绑定到单个仓库，具有更细粒度的权限控制。这使得 Deploy Key 成为在持续集成和部署流程中，从服务器安全地拉取代码的理想选择。

**主要特点：**

- **安全性高**：每个 Deploy Key 只能访问指定的仓库，避免了权限过大的风险。
- **独立管理**：Deploy Key 独立于个人账户，便于团队协作和管理。
- **简便性**：配置简单，适用于各种自动化部署场景。

## 相似方案对比，优缺点整理

在使用 Deploy Key 进行项目部署之前，了解其他常见的授权方式有助于做出更明智的选择。以下是几种常见方案的对比：

### 1. **Personal Access Token (PAT)**

**优点：**

- **灵活性高**：可以为不同的操作设置不同的权限。
- **适用范围广**：不仅限于 Git 操作，还可以用于 GitHub API 访问。

**缺点：**

- **安全性较低**：PAT 通常与个人账户关联，权限较大，一旦泄露风险较高。
- **管理复杂**：需要定期更新和管理权限，尤其在团队协作中更为繁琐。

### 2. **OAuth 应用**

**优点：**

- **集成性强**：适用于需要与第三方服务集成的场景。
- **细粒度权限控制**：可以精确控制应用的访问权限。

**缺点：**

- **实现复杂**：配置和管理较为复杂，适合中大型项目。
- **依赖外部服务**：需要依赖 OAuth 提供方的服务稳定性。

### 3. **Deploy Key**

**优点：**

- **安全性高**：仅限于特定仓库，权限可控。
- **易于管理**：独立于个人账户，便于在团队中共享和管理。
- **简便性**：配置简单，适用于自动化部署场景。

**缺点：**

- **作用范围有限**：每个 Deploy Key 只能绑定一个仓库，不适用于需要访问多个仓库的场景。

### 总结

对于需要安全、简便地从服务器拉取代码进行部署的场景，Deploy Key 是一个理想的选择。相比于 PAT，Deploy Key 提供了更细粒度的权限控制，降低了安全风险。而与 OAuth 应用相比，Deploy Key 的配置和管理更为简单，适合中小型项目的自动化部署需求。

## 服务器所需准备

在配置 Deploy Key 之前，需要确保服务器具备以下条件：

1. **操作系统**：本指南以 Linux 服务器为例，其他操作系统的步骤类似。
2. **SSH 客户端**：确保服务器已安装 SSH 客户端，以便与 GitHub 进行通信。
3. **Git 安装**：确保服务器上已安装 Git，便于拉取代码库。

### 检查 SSH 客户端和 Git 是否安装

```bash
# 检查 SSH 客户端
ssh -V

# 检查 Git 是否安装
git --version
```

如果未安装，可以使用以下命令进行安装：

```bash
# 对于 Debian/Ubuntu 系统
sudo apt update
sudo apt install -y git openssh-client

# 对于 CentOS/RHEL 系统
sudo yum install -y git openssh-clients
```

## GitHub 所需准备

在 GitHub 上配置 Deploy Key 涉及生成 SSH 密钥，并将公钥添加到仓库的 Deploy Keys 中。具体步骤如下：

1. **生成 SSH 密钥对**
2. **添加公钥到 GitHub 仓库**
3. **配置服务器上的私钥**

### 1. 生成 SSH 密钥对

在服务器上生成一个新的 SSH 密钥对，用于与 GitHub 进行安全通信。

```bash
ssh-keygen -t ed25519 -C "deploy-key-for-my-project"
```

**命令解释：**

- `-t ed25519`：指定密钥类型为 ED25519，更安全且推荐。
- `-C "deploy-key-for-my-project"`：添加注释，便于识别。

当提示输入保存路径时，建议使用默认路径或指定一个用于部署的路径，例如 `~/.ssh/deploy_key`。

这里一般不设置密码，以便自动化部署时无需手动输入。

```bash
Generating public/private ed25519 key pair.
Enter file in which to save the key (/home/user/.ssh/id_ed25519): /home/user/.ssh/deploy_key
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
```

### 2. 添加公钥到 GitHub 仓库

将生成的公钥添加到 GitHub 的目标仓库中，步骤如下：

1. **复制公钥内容**

   ```bash
   cat ~/.ssh/deploy_key.pub
   ```

   复制输出的公钥内容。

2. **登录 GitHub 并导航到目标仓库**

3. **进入仓库的设置**

   点击仓库页面右上角的 **Settings**。

4. **添加 Deploy Key**

   在左侧菜单中选择 **Deploy keys**，然后点击 **Add deploy key**。

5. **填写 Deploy Key 信息**

   - **Title**：为 Deploy Key 命名，例如 `Server Deploy Key`
   - **Key**：粘贴复制的公钥内容。
   - **Allow write access**：根据需要选择是否允许写权限。对于只需拉取代码的部署场景，保持默认的只读权限即可。

6. **确认添加**

   点击 **Add key** 完成添加。

### 3. 配置服务器上的私钥

确保服务器能够使用私钥进行 SSH 认证，不需要输入密码。

1. **创建 SSH 目录（如果尚未存在）**

   ```bash
   mkdir -p ~/.ssh
   chmod 700 ~/.ssh
   ```

2. **保存私钥并设置权限**

   将生成的私钥（如 `~/.ssh/deploy_key`）放置在合适的位置，并设置正确的权限。

   ```bash
   chmod 600 ~/.ssh/deploy_key
   ```

3. **配置 SSH 客户端**

   创建或编辑 `~/.ssh/config` 文件，添加如下配置：

   ```bash
   Host github-deploy
       HostName github.com
       User git
       IdentityFile ~/.ssh/deploy_key
       IdentitiesOnly yes
   ```

   这个配置为 GitHub 的连接指定了使用 Deploy Key，避免使用其他 SSH 密钥。

## 更新仓库

以下是使用 Deploy Key 从 GitHub 部署项目的详细步骤，包括代码拉取和部署自动化。

### 1. 克隆仓库

使用配置好的 SSH 主机别名 `github-deploy` 克隆仓库。

```bash
git clone git@github-deploy:username/repository.git
```

**示例：**

```bash
git clone git@github-deploy:silon-j/myproject.git
```

注意这里 @ 后面的内容和 github 上一键粘贴的内容是不同的。

这里就基本已经完成 deploy key 的配置和拉取的验证了。

### 2. 设置自动部署脚本

为了实现每次代码更新后自动部署，可以使用 GitHub 的 Webhooks 或者在服务器上设置定时任务（如使用 cron）。

以下以简单的 Git pull 脚本为例：

```bash
#!/bin/bash

# 定义项目目录
PROJECT_DIR=/path/to/myproject

# 进入项目目录
cd $PROJECT_DIR || exit

# 拉取最新代码
git pull origin main

# 重新启动服务（根据项目需求调整）
# 示例：使用 PM2 管理 Node.js 应用
pm2 restart myproject
```

将以上脚本保存为 `deploy.sh`，并赋予执行权限：

```bash
chmod +x deploy.sh
```


## 总结

使用 GitHub 的 Deploy Key 进行项目部署是一种安全、简便且高效的方法。通过将 SSH 公钥绑定到特定仓库，Deploy Key 能够确保服务器仅访问授权的代码库，降低了安全风险，也避免了多人协作时拉取项目的权限问题。



# 相关链接

- [GitHub Docs: About Deploy Keys](https://docs.github.com/en/developers/overview/managing-deploy-keys)
- [Webhook GitHub Integration](https://docs.github.com/en/developers/webhooks-and-events/webhooks/about-webhooks)
- [Webhook GitHub Example](https://github.com/adnanh/webhook)

```

使用 GitHub 的 Deploy Key 进行项目更新

## 变量和注释使用


### 变量解包

python 中可以对变量进行解构

```python
usernames = ['silon', 'sibine']

user_a, user_b = usernames
```


```python
# 可以对嵌套解构进行解构

attrs = [1, [66, 77]]

num1, (num2, num3) = attrs
```



同时可以对被解构的内容进行切片

```python
data = [1, 2, 3, 4, 5]

# 动态解构和切片赋值效果相同
a, *b, c = data

# 切片赋值
a, b, c = data[0], data[1:-1], data[-1]
```

### 变量类型注释

python 在 3.5 版本之后，提供了类型注释

类型注释用于标明变量的类型

需要注意的是：  
**类型注释只是一种注释，不提供任何校验功能**，如果需要校验类型，可以安装其他静态类型检查工具（mypy 等）


使用类型注释，可以配合 ide，得到更好的代码提示效果

```python
from typing import List
def remove_invalid(items: List[int]):
    """剔除 items 里面无效的元素"""
```


另外官方 也推荐使用 sphnix 格式的注释

```
def remove_invalid(items):
    """剔除 items 里面无效的元素
    
    :param items: 待剔除对象
    :type items: 包含整数的列表，[int, ...]
    """
```


### 变量命名规范

Python制定了官方的编码风格指南：PEP 8。这份风格指南里有许多详细的风格建议，比如应该用4个空格缩进，每行不超过79个字符，等等。其中，当然也包含变量的命名规范：

· 对于普通变量，使用蛇形命名法，比如max_value；  
· 对于常量，采用全大写字母，使用下划线连接，比如MAX_VALUE；  
· 如果变量标记为“仅内部使用”，为其增加下划线前缀，比如_local_var；  
· 当名字与Python关键字冲突时，在变量末尾追加下划线，比如class_。  


除了必须要遵守 pep8 标准，还需要保证以下要求，达到好的效果

- 描述性要强  
    要使用尽量精确的词语进行变量描述，避免使用 data、temp 等非常泛性的名称，容易与其他变量混淆
- 长度尽量短  
    可以结合上下文，进行变量名称的精简，例如可以把`how_many_points_needed_for_user_level3`直接删减成`level3_points`
- 匹配类型
    使用固定的命名格式，来表达该变量的类型
    常见组合例如：  
    
    | 类型 | 组合 |
    | --- | --- |
    | bool | is_super、 has_permission 、 allow_empty |
    | int和float| port、 age、 _cnt 、 _length |
    | list | 复数变量名: apples |
    | 其他  | 建议使用类型注释 |
    
    注意不要使用 复数格式，用于 int 类型变量
- 仅特定场景使用短命名
    
    | 场景 | 命名 |
    | --- | --- |
    | 数组索引 | i,j,k  |
    | 某个整数 | n |
    | 某字符串 | s |
    | 某异常  | e |
    | 文件对象 | fp |
- 同一段代码，不要出现多个相似变量，例如 name1，name2

    
### 注释使用规范

编写代码时，使用注释，有几个注意点

1. 不建议将注释作为临时屏蔽代码的工具  
    不要觉得注释掉的内容以后还要用，如果需要，可以从git 历史中寻找
2. 不要使用注释复述代码  
    注释作为代码之外的说明性文字，应该尽量提供那些读者无法从代码里读出来的信息。描述代码为什么要这么做，而不是简单复述代码本身。  
    错误示范：  
    ```python
    #调用strip()去掉空格
    input_string = input_string.strip(
    ```
    正确示范：
    ```python
    #如果直接把带空格的输入传递到后端处理，可能会造成后端服务崩溃
    # 因此使用strip() 去掉首尾空格
    input_string = input_string.strip(
    ```
3. 适当增加指引式注释  
    指引性注释的主要作用是降低代码的认知成本，让我们能更容易理解代码的意图。
    ```python
    #初始化访问服务的client对象
    token = token_service.get_token()
    service_client = ServiceClient(token=token)
    service_client.ready()
    # 调用服务获取数据，然后进行过滤
    data = service_client.fetch_full_data()
    for item in data:
        if item.value > SOME_VALUE:
        ...
    ```
    同时使用指引式注释，也能帮助自己梳理代码
    ```python
    service_client = make_client()
    data = fetch_and_filter(service_client)
    ```
4. 不要过度注释使用者不需了解的内容，例如编写代码的思路  


### 变量使用的建议

- 要保证变量的一致性
    - 名字一致性：不要把同一个事务，在一个系统里各处起不同的名称  
      例如 user_avatar_url, user_profile_url
    - 类型一致性：不要把同一个变量重复指向不同类型的值，应该创建新的变量来处理新的类型的值
      ```python
      def foo():
      users = {'data': ['piglei', 'raymond']}
      ...
      # 使用一个新名字
      user_list = []
      ...
      ```
- 变量的定义尽量靠近  
    不要一次性都在顶部把局部变量定义好，应该在即将使用到该临时变量时，再定义  
    好的例子如下
    ```python
    def generate_trip_png(trip):
    """
    根据旅途数据生成 PNG 图片
    """
    # 开始初始化 waypoints 数据
    waypoints = []
    waypoints.append(...)
    ...
    # 开始处理 photo_markers、text_markers
    photo_markers, text_markers = [], []
    photo_markers.append(...)
    ...
    # 开始计算 marker_count
    marker_count = 0
    marker_count += ..
    ```
- 为复杂处理，创建临时变量，提升可读性  
    最常见的就是，将复杂的条件判断，进行 flag 的赋值
    ```python
    #为所有性别为女或者级别大于3的活跃用户发放10000个金币
    user_is_eligible = user.is_active and (user.sex == 'female' or user.level > 3)
    if user_is_eligible:
        user.add_coins(10000)
    ```
- 同一作用域不要使用过多变量  
    要减少函数里的变量数量，最直接的方式是给这些变量分组，建立新的模型（数据类）
- 能不定义变量，就不定义  
    不需要过度优化，不必为了那些未来可能出现的变动，牺牲代码此时此刻的可读性。如果以后需要定义变量，那就以后再做
    ```python
    def get_best_trip_by_user_id(user_id):
        # 心理活动：嗯，这个值未来说不定会修改/二次使用，我们先把它定义成变量吧！
        user = get_user(user_id)
        trip = get_best_trip(user_id)
        result = {
            'user': user,
            'trip': trip
        }
        return result
    ```
    正确示例：  
    ```python
    def get_best_trip_by_user_id(user_id):
        return {
            'user': get_user(user_id),
            'trip': get_best_trip(user_id)
        }
    ```
- 不要使用 locals()  
    locals()是Python的一个内置函数，调用它会返回当前作用域中的所有局部变量  
    其他人在阅读代码时，为了搞明白模板渲染到底用了哪些变量，必须记住当前作用域里的所有变量  
    使用locals()还有一个缺点，那就是它会把一些并没有真正使用的变量也一并暴露

### 注释使用建议

- 适当使用空行区分代码块
- 尽量先写注释后写代码

Python 习惯改进- 变量和注释的使用

# GVM 安装指南

GVM（Go Version Manager）是一个用于管理 Go 语言版本的工具，可以让你方便地在多个 Go 版本之间切换。本文将介绍如何在你的系统上安装 GVM。

[官方项目地址](https://github.com/moovweb/gvm)





## 前期准备

### 在 macOS

```
xcode-select --install
brew update
brew install mercurial
```

### debian 或 ubuntu
```
sudo apt-get install curl git mercurial make binutils bison gcc build-essential
```

### 其他 linux 发行版本
[查看官方文档](https://github.com/moovweb/gvm)


## 安装 GVM

1. **打开终端**。

2. **输入以下命令下载并安装 GVM**：

```bash
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer)
```

![image.png](https://oss.silon.vip/img/d80019f9f147d5bfde2898b3cb4f4876.image.webp)

3. **激活 GVM**：

   安装后，你需要将 GVM 的初始化脚本添加到你的 Shell 配置文件中。根据使用的 shell 类型，选择相应的配置文件：

    对于 **bash** 用户：
     ```bash
     source /Users/silon/.gvm/scripts/gvm
     source ~/.bashrc
     ```

    对于 **zsh** 用户：
     ```bash
     source /Users/silon/.gvm/scripts/gvm
     source ~/.zshrc
     ```
 
4. **验证安装**：

   你可以通过运行以下命令来验证 GVM 是否已正确安装：

   ```bash
   gvm version
   ```

   如果安装成功，你将看到 GVM 的版本信息。
 
![image.png](https://oss.silon.vip/img/755a82122592daeffd7674d1fc5a7ce3.image.webp)
 

# 使用 GVM 管理 Go 版本

安装后，你可以使用以下命令来管理 Go 语言版本：

1. **列出可用的 Go 版本**：

   ```bash
   gvm listall
   ```

2. **安装指定版本的 Go**：

   例如，要安装 Go 1.17：

   ```bash
   gvm install go1.17
   ```

3. **使用指定的 Go 版本**：

   使用以下命令激活已安装的 Go 版本：

   ```bash
   gvm use go1.17
   ```

4. **查看当前使用的 Go 版本**：

   可以通过以下命令查看当前激活的 Go 版本：

   ```bash
   go version
   ```

## 示例

假设你想安装并使用 Go 的最新稳定版 1.20。可以按照以下步骤操作：

1. 使用 GVM 安装 Go 1.20：

   ```bash
   gvm install go1.20
   ```

2. 使用 Go 1.20：

   ```bash
   gvm use go1.20
   ```

3. 验证当前版本：

   ```bash
   go version
   ```

以上步骤应该能顺利地让你在 macOS 上使用 Homebrew 安装和使用 GVM 以及管理 Go 版本。


![image.png](https://oss.silon.vip/img/200f1e9b66ab9e2bd3fc0d3926d60b4d.image.webp)


# 卸载 GVM

如果你需要卸载 GVM，可以使用以下命令：

```bash
rm -rf $HOME/.gvm
```

并记得从你的 shell 配置文件中删除 GVM 的初始化脚本。

golang 多版本管理器 gvm

## 问题说明

vite 中已经配置了 @ 路径
```ts
  resolve: {
    alias: {
      '@': resolve(__dirname, "./src"),
    }
  }
```
并且路径已经可以识别，但是编辑器提示ts无法识别

![image.png](https://oss.silon.vip/img/515720c5c8e0294e642f6e7a04f846b9.image.webp)

## 解决方法

修改ts检查配置，找到tsconfig.json 或其引用的配置文件，对 `compilerOptions` 项中添加`path`配置

```
"compilerOptions": {
    /* 项目自定义配置 */
    "paths": {
      "@/*": ["./src/*"]
    },
}
```

vite 中设置@ 路径，ts报错 2307

## 解决办法：

1、在github desktop中，点击"File"-"Options"；

2、在弹出的页面中，点击左侧的"Git"；

3、在"Git"对应的右侧，点击"edit your global Git config file."；





![image.png](https://oss.silon.vip/img/8e2dba3cae4e6725fcf3fe3c61ab3acd.image.webp)

4、在打开的.gitconfig文件中，增加如下内容

```
[core]
autocrlf = false
```

![image.png](https://oss.silon.vip/img/c981e81b3fe67cc1f8fe1a755d2b39b3.image.webp)


5、回到弹出页面，点击"Save"


![image.png](https://oss.silon.vip/img/edd013591a426b90d668fa09c4367881.image.webp)