官方文档：https://docs.jianmu.dev/guide/quick-start.html

一、环境准备

• 操作系统： Ubuntu / 20.04 LTS amd64 (64bit) (百度云服务器)
  CPU： 1核
  内存： 2GB

• Docker
  Docker安装
  Docker安装
  Docker Engine - Community
  Version: 20.10.17
  

• Docker-Compose
  Docker-Compose安装
  docker-compose version 1.29.2, build 5becea4c

注意：教程上说需要安装Dcoker-Compose以及Kubernetes，实际两者择其一即可。

二、安装建木

docker-compose部署

1）下载docker-compose.yml

wget https://gitee.com/jianmu-dev/jianmu-deploy/raw/master/docker-compose.yml
1

2）启动

docker-compose up -d
1

3）访问http://localhost，默认用户名密码为admin/123456。
注意：这里我用的百度云服务器，在本机上使用http://云服务器IP来访问。

三、快速应用

1. 创建一个公有项目

在GitLink平台（也可以选择Gitee/Github）新建一个项目。项目中有新建hello.yml文件。

示例的yaml文件内容如下：

name: hello_world
description: 建木快速入门，从hello world开始！

trigger:
  type: cron
  schedule: 0 0/30 * * * ?

workflow:
  start:
    type: start
    targets:
      - sayhello
  sayhello:
    type: qywx_notice:1.2.1
    param:
      bot_webhook_url: "((wecom.bot_webhook))"
      text_content: "这是来自建木的第一个问候！"
    sources:
      - start
    targets:
      - end
  end:
    type: end
    sources:
      - sayhello
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

2. 前提条件说明

• 有企业微信账号 或者钉钉账号，这里我使用的是钉钉账号

• 新建一个测试群
  

• 测试群添加一个机器人，并获取机器人的webhook，形如：https://oapi.dingtalk.com/robot/send?access_token=0d2abe1ebea52b2080414b8d5f*******70adf

添加流程可参考gitee相关文档

注意：我这里安全设置用得是IP地址，填写的是我云服务器的IP地址。

3. 设置命名空间，关联流程和机器人

点击“密钥管理”

点击“新增命名空间”，新增一个密钥命名空间
注意：命名空间的名称不能更改，这个需要与后面hello-world.yml中的名字进行匹配。

进入该命名空间，给该命名空间新增密钥。密钥的值就是上面钉钉机器人的webhook地址。
注意：密钥名称不能更改，这个需要与后面hello-world.yml中的名字进行匹配。

4. 导入项目（新建项目）

点击“导入项目”

进行项目导入操作

5. 执行项目

选择项目，点击“触发”，项目开始执行

查看钉钉，已经收到了发送的消息

流程也显示是执行成功的

plus: 私有项目的处理

如果新建的项目是一个私有项目，需要增加HTTPS认证。

官方文档如下说明：

1. 首先新增gitlink的命名空间以及密钥用户名和密码。
   
2. 导入项目时，开启认证，选择上述用户名和密码
   
3. 后续步骤与上述一样。