# mep-agent

**Repository Path**: edgegallery/mep-agent

## Basic Information

- **Project Name**: mep-agent
- **Description**: Mep-Agent是为第三方应用程序提供代理服务的中间件。它可以帮助未实现ETSI接口的应用注册到MEP，并实现应用服务注册和发现
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 55
- **Forks**: 21
- **Created**: 2020-08-05
- **Last Updated**: 2024-01-09

## Categories & Tags

**Categories**: iot

**Tags**: None

## README

# Mep-Agent

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
![Jenkins](https://img.shields.io/jenkins/build?jobUrl=http://jenkins.edgegallery.org/view/mep/job/mep-agent-docker-build-master/)

## 介绍
Mep-Agent是为第三方应用程序提供代理服务的中间件。它可以帮助未实现ETSI接口的应用注册到MEP，并实现应用服务注册和发现。
Mep-Agent将与应用程序容器同时启动，并读取conf/app_instance_info.yaml文件中的内容以自动注册服务。

## MEP-Agent代码目录

```
├─conf
├─docker
├─src
│  ├─config
│  ├─controllers
│  ├─main
│  ├─model
│  ├─router
│  ├─service
│  ├─test
│  └─util
└─views
    └─error
```

上面是MEP-Agent项目的目录树，其用法如下：
- conf: mep-agent配置文件 
- docker: dockerfile文件
- src: 源代码
  - config: 配置文件
  - controllers: controller类
  - main: main方法
  - model: 模型定义
  - router: 路由
  - service: 业务逻辑层
  - test: 单元测试目录
  - util: util工具类
- views: 页面

## 构建以及运行

Mep-Agent由Go语言开发，并以docker映像的形式提供服务。当启动时，它将读取配置文件，并将应用程序注册到MEP以实现服务注册和发现。


- ### 构建

    git clone mep-agent代码
    ```
    git clone https://gitee.com/edgegallery/mep-agent.git
    ```
  
    构建mep-agent镜像
    ```
    docker build -t mep-agent:latest -f docker/Dockerfile .
    ```
  
- ### 运行

    准备包含ACCESS_KEY和SECRET_KEY的证书文件和mepagent.properties，并执行
    ```
    docker run -itd --name mepagent \
      --cap-drop All \
      -e MEP_IP=<host IP> \ # host IP 为mep部署环境的IP地址
      -e MEP_APIGW_PORT=8443 \
      -e MEP_AUTH_ROUTE=mepauth \
      -e ENABLE_WAIT=true \
      -e AK=QVUJMSUMgS0VZLS0tLS0 \
      -e SK=DXPb4sqElKhcHe07Kw5uorayETwId1JOjjOIRomRs5wyszoCR5R7AtVa28KT3lSc \
      -e APPINSTID=5abe4782-2c70-4e47-9a4e-0ee3a1a0fd1f \
      -v /home/EG-LDVS/mepserver/ca.crt:/usr/mep/ssl/ca.crt:ro \
      -e "CA_CERT=/usr/mep/ssl/ca.crt" \
      -e "CA_CERT_DOMAIN_NAME=edgegallery" \
      -v /tmp/mepagent-conf/app_conf.yaml:/usr/mep/conf/app\_conf.yaml:ro \
      -v /home/EG-LDVS/mep-agent/conf/app_instance_info.yaml:/usr/mep/conf/app_instance_info.yaml:ro\ #可选， mep-agent默认自带一份样例app_instance_info.yaml用于注册
      edgegallery/mep-agent:latest
    ```

有关mepagent.properties以及构建和安装过程的更多详细信息，请参阅 [HERE](https://gitee.com/edgegallery/docs/blob/master/Projects/MEP/EdgeGallery%E6%9C%AC%E5%9C%B0%E5%BC%80%E5%8F%91%E9%AA%8C%E8%AF%81%E6%9C%8D%E5%8A%A1%E8%AF%B4%E6%98%8E%E4%B9%A6.md).
  
## 注意

Mep-Agent用Go语言编写。为了使镜像最小化，它采用了静态编译然后打包的过程，而不依赖于基本的Go语言镜像，从而大大减小了镜像的大小。