Github Action

Github Actions 是由 Github 创建的 CI/CD 服务。 它的目的是使所有软件开发工作流程的自动化变得容易。 直接从 GitHub 构建，测试和部署代码。CI（持续集成）由很多操作组成，比如代码合并、运行测试、登录远程服务器，发布到第三方服务等等。GitHub 把这些操作就称为 actions。

很多操作在不同项目里面是类似的，完全可以共享。GitHub 允许开发者把每个操作写成独立的脚本文件，存放到代码仓库，使得其他开发者可以引用。

如果你需要某个 action，不必自己写复杂的脚本，直接引用他人写好的 action 即可，整个持续集成过程，就变成了一个 actions 的组合。这就是 GitHub Actions 最特别的地方。

GitHub 做了一个GitHub Marketplace ，可以搜索到他人提交的 actions。另外，还有一个Awesome Actions的仓库，也可以找到不少 action。

基础概念

GitHub Actions 有一些自己的术语。

• workflow （工作流程）：持续集成一次运行的过程。
• job （任务）：一个 workflow 由一个或多个 job 构成，含义是一次持续集成的运行，可以完成多个任务。
• step（步骤）：每个 job 由多个 step 构成，一步步完成。
• action （动作）：每个 step 可以依次执行一个或多个命令（action）。

虚拟环境

GitHub Ac­tions 为每个任务 (job) 都提供了一个虚拟机来执行，每台虚拟机都有相同的硬件资源：

• 2-core CPU, 7 GB RAM 内存, 14 GB SSD 硬盘空间
• 硬盘总容量为 90G 左右，可用空间为 30G 左右，评测详见：《GitHub Actions 虚拟服务器环境简单评测》

使用限制：

• 每个仓库只能同时支持 20 个 workflow 并行。
• 每小时可以调用 1000 次 GitHub API 。
• 每个 job 最多可以执行 6 个小时。
• 免费版的用户最大支持 20 个 job 并发执行，macOS 最大只支持 5 个。
• 私有仓库每月累计使用时间为 2000 分钟，超过后$ 0.008/分钟，公共仓库则无限制。
• 操作系统方面可选择 Win­dows server、Linux、ma­cOS，并预装了大量软件包和工具。

TIPS： 虽然名称叫持续集成，但当所有任务终止和完成时，虚拟环境内的数据会随之清空，并不会持续。即每个新任务都是一个全>新的虚拟环境。

workflow 文件

GitHub Ac­tions 的配置文件叫做 work­flow 文件，存放在代码仓库的.github/workflows 目录中。

work­flow 文件采用 YAML 格式，文件名可以任意取，但是后缀名统一为.yml，比如 build.yml。一个库可以有多个 work­flow 文件，GitHub 只要发现.github/workflows 目录里面有.yml 文件，就会按照文件中所指定的触发条件在符合条件时自动运行该文件中的工作流程。

在 Ac­tions 页面可以看到很多种语言的 work­flow 文件的模版，可以用于简单的构建与测试。下面是一个简单的 work­flow 文件示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

name: Hello World
on: push
jobs:
  my_first_job:
    name: My first job
    runs-on: ubuntu-latest
    steps:
    - name: checkout
      uses: actions/checkout@master
    - name: Run a single-line script
      run: echo "Hello World!"
  my_second_job:
    name: My second job
    runs-on: macos-latest
    steps:
    - name: Run a multi-line script
      env:
        MY_VAR: Hello World!
        MY_NAME: P3TERX
      run: |
        echo $MY_VAR
        echo My name is $MY_NAME

workflow 语法

(1) name

name 字段是 work­flow 的名称。若忽略此字段，则默认会设置为 work­flow 文件名。

1

name: GitHub Actions Demo

(2) on

on 字段指定 work­flow 的触发条件，通常是某些事件，比如示例中的触发事件是 push，即在代码 push 到仓库后被触发。on 字段也可以是事件的数组，多种事件触发，比如在 push 或 pull_request 时触发：

1

on: [push, pull_request]

• push 指定分支触发

1
2
3
4

on:
  push:
    branches:
      - master

• push tag 时触发

1
2
3
4

on:
  push:
    tags:
    - 'v*'

完整的事件列表，请查看官方文档。除了代码库事件，GitHub Actions 也支持外部事件触发，或者定时运行。

(3) jobs

jobs 表示要执行的一项或多项任务。每一项任务必须关联一个 ID (jobid)，比如示例中的 my_first_job 和 my_second_job。job_id 里面的 name 字段是任务的名称。job_id 不能有空格，只能使用数字、英文字母和 - 或符号，而 name 可以随意，若忽略 name 字段，则默认会设置为 job_id。

当有多个任务时，可以指定任务的依赖关系，即运行顺序，否则是同时运行。

1
2
3
4
5
6

jobs:
  job1:
  job2:
    needs: job1
  job3:
    needs: [job1, job2]

上面代码中，job1 必须先于 job2 完成，而 job3 等待 job1 和 job2 的完成才能运行。因此，这个 work­flow 的运行顺序依次为：job1、job2、job3。

(4) runs-on

1

runs-on: ubuntu-18.04

runs-on 字段指定任务运行所需要的虚拟服务器环境，是必填字段，目前可用的虚拟机如下：

（5）steps

steps 字段指定每个任务的运行步骤，可以包含一个或多个步骤。步骤开头使用 - 符号。每个步骤可以指定以下字段:

• name：步骤名称。
• uses：该步骤引用的 action 或 Docker 镜像。
• run：该步骤运行的 bash 命令。
• env：该步骤所需的环境变量。 其中 uses 和 run 是必填字段，每个步骤只能有其一。同样名称也是可以忽略的。

action

action 是 GitHub Ac­tions 中的重要组成部分，这点从名称中就可以看出，actions 是 action 的复数形式。它是已经编写好的步骤脚本，存放在 GitHub 仓库中。

对于初学者来说可以直接引用其它开发者已经写好的 action，可以在官方 action 仓库或者 GitHub Marketplace 去获取。此外 Awesome Actions 这个项目收集了很多非常不错的 action。 既然 action 是代码仓库，当然就有版本的概念。引用某个具体版本的 action：

1
2
3
4

steps:
  - uses: actions/setup-node@74bc508 # 指定一个 commit
  - uses: actions/setup-node@v1.2    # 指定一个 tag
  - uses: actions/setup-node@master  # 指定一个分支

进入https://github.com/

1. 注册账号后右上角导入仓库，如图 ( 有能力的自己新建仓库 然后拉取代码后手动执行一次工作流 ）

   

2. 点击Import a repository.

   

3. 在 Your old repository’s clone URL 输入下面链接

   1	https://github.com/zero205/JD_tencent_scf

   Repository name 仓库名字随便起名，将仓库改为私有，然后点击 Begin import，完成导入

   

4. 将分支切换为 main 分支后，在下拉菜单中点击最下方’view all branches’，点击’Default branch’最右侧箭头,然后在新页面继续点击箭头,再弹出框中选择’scf’为主分支
   
   
   5. 点击 Updata 后，确定更改 scf 为主分支
   6. 然后回到代码仓库中，在仓库页面点击’main’分支,在下拉菜单中点击最下方’view all branches’,点击’maim’分支右侧垃圾桶,确认删除分支
   7. 点击刚才页面’scf’分支右侧笔图标,将其重命名为’main’
   

1. PAT(Personal Access Token)模式
   即用私人访问命令的形式来判断该账户是否有权限接触仓库。通过 github 配置有一定限制性的密钥，并将其发放给其他开发人员，以共同完成代码仓库的开发和管理。

   注意 PAT 的隐私性，PAT 只会在生成时显示一次！保证你的 PAT 权限只勾选了你所需要的权限，永远不要将所有权限都开放给未知的人和事物，永远不要泄露你的 PAT！

2. 申请 PAT
   点此来生成一个 token ，把 repo和workflow 两部分勾上，然后点击最下面的创建按钮。

3. 填写 PAT 到 Secrets申请完毕后，在分支中点击Settings-Secrets-New secret

   name填PAT，Value填入上方申请到的 PAT,保存即可

   

   

4. 手动触发一次代码同步点击Actions，执行Run Workflows

   

   等待两分钟左右,能够发现代码全部同步过来

依次登录 SCF 云函数控制台 和 SLS 控制台 开通相关服务，确保账户下已开通服务并创建相应服务角色 SCF_QcsRole、SLS_QcsRole

注意！为了确保权限足够，获取这两个参数时不要使用子账户！此外，腾讯云账户需要实名认证。

新建腾讯云密钥（用于身份识别）

在这里新建一个访问密钥 新建密钥

新建完成后你可以得到你的SecretId和SecretKey

将 SecretId 和 SecretKey 分别配置在仓库的 secrets 变量里面

TENCENT_SECRET_ID 对应你的 SecretId 的值

TENCENT_SECRET_KEY 对应你的 SecretKey 的值

在 github 中配置 secrets 变量

secrets 变量位置 : Settings–左边栏的Secrets–右上角New repository secret–Name填变量名称,Value填变量值

浏览器获取京东 cookie

以下浏览器都行

• Chrome 浏览器
• 新版 Edge 浏览器
• 国产 360，QQ 浏览器切换到极速模式

操作步骤

1. 电脑浏览器打开京东网址 https://m.jd.com/

2. 按键盘 F12 键打开开发者工具，然后点下图中的图标
   

3. 此时是未登录状态(使用手机短信验证码登录)，如已登录请忽略此步骤

   • 使用手机短信验证码登录(此方式 cookie 有效时长大概 31 天，其他登录方式比较短)

4. 登录后，选择 Network,有很多链接的话点箭头这里清空下
   

5. 然后再点我的，链接就变少了
   

6. 点第一个链接(log.gif)进去，找到 cookie，复制出来，新建一个 TXT 文本临时保存一下，下面需要用到
   

7. 第六步复制出来的 cookie 比较长，我们只需要pt_pin=xxxx;和 pt_key=xxxx;部分的内容即可(注:英文引号;是必要的)。可以用下面的脚本，在 Chrome 浏览器按 F12，console 里面输入下面脚本按 enter 回车键
   

   1 2 3

   var CV = "单引号里面放第六步拿到的cookie"; var CookieValue = CV.match(/pt_pin=.+?;/) + CV.match(/pt_key=.+?;/); copy(CookieValue);

8. 这样子整理出关键的的 cookie 已经在你的剪贴板上， 可直接粘贴

9. 如果需获取第二个京东账号的 cookie,不要在刚才的浏览器上面退出登录账号一(否则刚才获取的 cookie 会失效),需另外换一个浏览器(Chrome 浏览器 ctr+shift+n 打开无痕模式也行),然后继续按上面步骤操作即可

插件获取京东 cookie

此教程内容由 tg 用户@wukongdada 提供,特此感谢

以下浏览器都行

• Chrome 浏览器
• 新版 Edge 浏览器(chrome 内核)

操作步骤

1. 电脑浏览器打开京东网址 https://m.jd.com/
2. Chrome 类浏览器安装 EditThisCookie 插件
   • Chrome 插件商店搜 EditThisCookie, 或者打开此网站 进行安装
   • 仅使用百分浏览器，谷歌浏览器测试过，其他谷歌类浏览器请自行测试。
   • 无法登录 Chrome 插件商店或者打不开网址建议使用 edge chrome 版。
3. edge chrome 浏览器安装 Cookie Editor 插件 - edge 插件商店搜 Cookie Editor，或打开以下网址 完成插件安装
4. 输入的网址是 jd.com
5. 现在点击回到京东触屏版，再点击 EditThisCookie/Cookie Editor，再点击搜索，输入 key 或 pin，如下图所示的 pt_key，复制 pt_key 的 value 值。此插件可以看到 cookie 的有效期。
   
6. 按照以下格式形成自己的 jd_cookie
   • pt_key=复制插件搜索出来的key值;pt_pin=复制插件搜索出来的pin值; ,后面的英文引号;是必须要的
   • 给一个京东 cookie 具体示例 pt_key=jdDC2F833333EFDGTCE5BD4AD1A952D4F4DF84A46052;pt_pin=jd_123456;
7. 如果需获取第二个京东账号的 cookie,不要在刚才的浏览器上面退出登录账号一(否则刚才获取的 cookie 会失效),需另外换一个浏览器(Chrome 浏览器 ctr+shift+n 打开无痕模式也行),然后继续按上面步骤操作即可

secret 变量有三个选填变量 SCF_REGION,TENCENT_FUNCTION_NAME,TENCENTSCF_MEMORYSIZE.都有默认值,可不修改.

SCF_REGION用于控制部署区域的选择，默认值为ap-guangzhou，其他地区具体参数代码填写可以自行查找官方说明 地域和可用区

TENCENT_FUNCTION_NAME用于控制部署到云函数后函数名的命名,别瞎改,改名的话确保之前的已经删除 默认值为JD

TENCENTSCF_MEMORYSIZE值为运行内存大小的设定值，默认值为64，需求更大内存的可填入128，云函数有 128MB 就能满足了

请注意提高内存设定值相应地也会加快消耗云函数的免费额度，超出免费额度将会产生费用

下图 workflow 名字现在叫做 Deploy

查看和测试

登录后，在 腾讯云函数地址 点击管理控制台，查看最新部署的函数。

在左侧栏的日志查询中，可以查看到触发的日志，包括是否打卡成功等。

请点击右下角切换旧版编辑器!

自己参照图内填写测试脚本名称,不带后缀,测什么,填什么

如果出错了，排查问题第一步先看自己腾讯云函数那边的环境变量跟自己在仓库配置的 secrets 是否一致

京东(必须)

京东隐私安全 环境变量

推送通知环境变量(目前提供微信server酱、pushplus(推送加)、iOS Bark APP、telegram机器人、钉钉机器人、企业微信机器人、iGot等通知方式)

互助码类环境变量

控制脚本功能环境变量