**插件原作者 Github [broadlink_ac_mqtt](https://github.com/liaan/broadlink_ac_mqtt)**

## 前言

奥克斯的官方的APP简直难用，延迟经常十来秒。

最近在折腾hass，官方集成好像不支持aux。

在路由器看到几台空调的主机名都是BroadLink_OEM-T1-XX-XX-XX类似的，猜测用的都是博联的集成方案。

一番搜索找了个还行的插件，特来分享安装过程。





## 步骤

### 1. 安装 docker

安装后确认命令

```bash
docker --version
```

### 2. 安装MQTT broker

- 创建目录

```bash
mkdir -p /docker/mosquitto/config
mkdir -p /docker/mosquitto/data
mkdir -p /docker/mosquitto/log
```

- 初始化配置文件

```bash
vi /mosquitto/config/mosquitto.conf
```

```conf
persistence true
persistence_location /mosquitto/data/
log_dest file /mosquitto/log/mosquitto.log

listener 1883
# 关闭匿名模式
allow_anonymous false
# 指定密码文件
password_file /mosquitto/config/pwfile.conf

```


6、运行

```bash
docker run -it --name=mosquitto --privileged \
-p 1883:1883  \
-v /mosquitto/config/mosquitto.conf:/mosquitto/config/mosquitto.conf \
-v /mosquitto/data:/mosquitto/data \
-v /mosquitto/log:/mosquitto/log \
eclipse-mosquitto
```

### 3. 安装broadlink_ac_mqtt 插件

- 创建配置文件config.yml ，根据自己的环境修改MQTT的配置和设备的信息

```yaml
service:
   daemon_mode: True
   #更新间隔
   update_interval: 10
   #在局域网中自动发现博联设备 
   #但是不支持中文设备 所以关闭
   self_discovery: False
   bind_to_ip: False

mqtt:
   #mqtt服务的ip地址
   host: mqtt
   #mqtt服务的端口
   port: 1883
   client_id: ac_to_mqtt
   #mqtt服务的用户名
   user: user
   #mqtt服务的用户名
   passwd: 'passwork'
   #空调信息的topic 不需要改
   topic_prefix: /aircon
   #HA 自动发现实体的topic 不需要改
   auto_discovery_topic: homeassistant
   auto_discovery_topic_retain: True
   #HA 自动发现实体的开关
   discovery: True

##设备配置
devices:
   - ip: 192.168.xxx.xxx
      #设备MAC地址，去掉冒号(a1:b2:c3:d4:e5:f6 填写为a1b2c3d4e5f6)
     mac: a1b2c3d4e5f6
      #设备名 注意不能用中文
     name: Master bedroom ac
      #端口号 为80 （仅在奥克斯空调测试）
     port: 80
   - ip: 192.168.xxx.xxx
     mac: a1b2c3d4e5f6
     name: Living room ac
     port: 80
   - ip: 192.168.xxx.xxx
     mac: a1b2c3d4e5f6
     name: Second bedroom
     port: 80
   - ip: 192.168.xxx.xxx
     mac: a1b2c3d4e5f6
     name: Guest bedroom
     port: 80
```

- 新建文件夹 /docker/ac2mqtt 并将配置文件放入其中（**这里只是示例，建议放HA配置文件夹同级**）
```bash
mkdir -p /docker/ac2mqtt
cp config.yml /docker/ac2mqtt/
```
- 启动 broadlink_ac_mqtt 插件容器

```bash
docker run -d --name ac2mqtt broadlinkac/broadlink_ac_mqtt:latest  --net="host" -v /docker/ac2mqtt:/config -e TZ="Asia/Shanghai"
```

### 4. 启动HA自动发现MQTT实体

安装mqtt集成

在HA的配置文件中加入

 ```yaml
 mqtt:
   discovery: true
   discovery_prefix: homeassistant
 ```

Aux空调接入home assistant

# 基于docker和gitlab-runner的一次CI/CD实践


##   项目以容器方式构建

### 添加dockerFile

编写dockerFile

```dockerfile
FROM openjdk:8-jdk-alpine
RUN adduser --disabled-password --gecos '' testuser
USER testuser
ARG JAR_FILE=target/*.jar
COPY ${JAR_FILE} /home/testuser/app.jar
ENTRYPOINT ["java","-jar","/home/testuser/app.jar"]
```



### maven中集成docker镜像构建

添加spotify的dockerFile maven 插件

```xml
<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>dockerfile-maven-plugin</artifactId>
    <version>1.4.13</version>
    <executions>
        <execution>
            <id>default</id>
            <goals>
                <goal>build</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <repository>${docker.image.prefix}/${project.name}</repository>
        <tag>${project.version}</tag>
        <buildArgs>
            <JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
        </buildArgs>
        <dockerfile>${project.basedir}/Dockerfile</dockerfile>
    </configuration>
</plugin>
```

## 使用docker-compose在开发和测试环境中编排容器

- 修改application.yml，加入环境变量。


```yaml

server:
  port: ${SERVER_PORT:8080}
logging:
  level:
    com.demo: ${LOG_LEVEL:debug}
  file:
    name: ${LOG_PATH:./logs}/demo.log

```

- 编写docker-compose.yml


```yaml
version: '3'

services:
  web:
    ports:
      - 8080:8080
    image: test/demo:1.0-SNAPSHOT
    networks:
      - test_network
    volumes:
      - ./logs:/logs
    environment:
      - LOG_LEVEL=${LOG_LEVEL}
      - LOG_PATH=${LOG_PATH}

networks:
  test_network:
    driver: bridge
    ipam:
      driver: default
      config:
        - subnet: 172.16.1.0/24
```

## 添加 gitlab-runner 流水线

### 安装Docker Engine - Community

检查docker是否安装以及版本

```bash
$ sudo docker version
```
若输出如下则表示Docker Client和Server均安装成功。

```text
Client: Docker Engine - Community
 Version:           20.10.7
 API version:       1.41
 Go version:        go1.13.15
 Git commit:        f0df350
 Built:             Wed Jun  2 11:58:10 2021
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server: Docker Engine - Community
 Engine:
  Version:          20.10.7
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.13.15
  Git commit:       b0f5bc3
  Built:            Wed Jun  2 11:56:35 2021
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.4.6
  GitCommit:        d71fcd7d8303cbf684402823e425e9dd2e99285d
 runc:
  Version:          1.0.0-rc95
  GitCommit:        b9ee9c6314599f1b4a7f497e1f1f856fe433d3b7
 docker-init:
  Version:          0.19.0
  GitCommit:        de40ad0
```

若未安装则参考：[docker 安装文档](https://docs.docker.com/engine/install/centos/)。

### 安装docker-compose  

- 下载

```bash
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
```

- 权限

```bash
sudo chmod +x /usr/local/bin/docker-compose
```

- 链接

```bash
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
```

- 校验

```bash
$ docker-compose --version
docker-compose version 1.29.2, build 5becea4c
```

参考：[docker-compose 安装文档](https://docs.docker.com/compose/install/)。

### 安装Gitlab-runner

- 安装git maven
```bash
sudo yum install git maven
```
- 下载
```bash
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_${arch}.rpm"
```
- 安装

```bash
rpm -i gitlab-runner_${arch}.rpm
```
- 校验

```bash
$ systemctl status gitlab-runner.service
● gitlab-runner.service - GitLab Runner
   Loaded: loaded (/etc/systemd/system/gitlab-runner.service; enabled; vendor preset: disabled)
   Active: active (running) since Tue 2021-06-15 15:03:31 CST; 51s ago
 Main PID: 31521 (gitlab-runner)
    Tasks: 10
   Memory: 5.5M
   CGroup: /system.slice/gitlab-runner.service
           └─31521 /usr/bin/gitlab-runner run --working-directory /home/gitlab-runner --config /etc/gitlab-runner/config.toml --service gitlab-runner --user gitlab-runner

```

​      	参考：[Gitlab-runner安装文档](https://docs.gitlab.com/runner/install/linux-manually.html)

- 修改启动用户，文件：/etc/systemd/system/gitlab-runner.service。

### 注册runner并编写.gitlab-ci.yml

- 注册，见[注册文档](https://docs.gitlab.com/runner/register/index.html#linux)。

- 编写.gitlab-ci.yml。

   ```yml
   stages:
     - build
     - deploy-dev
   
   build:
     stage: build
     tags:
       - demo-runner
     only:
       refs:
         - dev/1.0
     script:
       - mvn clean package -Dmaven.test.skip=true
   
   deploy-dev:
     stage: deploy-dev
     tags:
       - demo-runner
     only:
       refs:
         - dev/1.0
     script:
       - sudo -u testuser whoami
       - sudo -u testuser mkdir -p /home/testuser/demo-project
       - sudo -u testuser cp -r ./docker-compose/. /home/testuser/demo-project
       - cd /home/testuser/demo-project
       - chmod +x ./init.sh
       - sudo -u testuser ./init.sh
       - sudo -u testuser sudo docker-compose up -d
     needs:
       - job: build
   
   
   ```