# mep

**Repository Path**: lisongyang1/mep

## Basic Information

- **Project Name**: mep
- **Description**: No description available
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 55
- **Created**: 2020-08-06
- **Last Updated**: 2020-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EdgeGallery MEP project

[![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%3A%2F%2Fjenkins.edgegallery.org%2Fview%2FMEC-PLATFORM-BUILD%2Fjob%2Fmep-docker-image-build-update-daily-master%2F)

## Introduction

Edgegallery MEP is an open source implementation of MEC platform according to
ETSI MEC 003 [1] and 011 [2] documentation.

The MEC platform, as defined in ETSI GS MEC 003, offers an environment
where MEC applications may discover, advertise, consume and offer MEC services.
Upon receipt of update, activation or deactivation of traffic rules from the
MEC platform manager, applications or services, the MEC platform instructs the
data plane accordingly. The MEC platform also receives DNS records from the MEC
platform manager and uses them to configure a DNS proxy/server.
 
Via Mp1 reference point between the MEC platform and the MEC applications,
as defined in ETSI GS MEC 011, the basic functions are enabled, such as:
* MEC service assistance:
    - authentication and authorization of producing and consuming MEC services;
    - a means for service producing MEC applications to register/deregister
    towards the MEC platform the MEC services they provide, and to update the
    MEC platform about changes of the MEC service availability;
    - a means to notify the changes of the MEC service availability to the
    relevant MEC application;
    - discovery of available MEC services;
* MEC application assistance:
    - MEC application availability subscription;
    - MEC application termination subscription;

## MEP architecture

MEP Mp1 service registry and discovery bases on servicecomb service center [3].
Servicecomb service center is a Restful based service-registry that provides micro-services discovery and micro-service management. MEP utilize its registry abilities and plugin mechanism to implement Mp1 interfaces.
The mep-server module is the core implementations of MEP server for Mp1 APIs. The APIs is provided for MEC Apps to register or discover services in MEC platform.

## MEP code directory
```
├── kong-plugin
│   ├── appid-header
│   └── kong.conf
├── mepauth
├── mepserver
└── README.md

```
Above is the directory tree of MEP project, their usage is as belows:
- kong-plugin: mep api gateway kong plugin
- mepserver: mep server implementation
- mepauth: mepauth module provide token apply api for Apps

## MEP build & run

Most of the MEP project codes are developed by golang, the kong plugin is by lua. MEP project is released via docker image.

### build mep-auth

```
cd mepauth
sudo ./docker-build.sh

```

### build mep-server

```
cd mepauth
sudo ./docker-build.sh
```

### run mepauth

```
docker run -itd --name mepauth \
             --cap-drop All \
             --network mep-net \
             --link kong-service:kong-service \
             -v ${MEP_CERTS_DIR}/jwt_publickey:${MEPAUTH_KEYS_DIR}/jwt_publickey:ro \
             -v ${MEP_CERTS_DIR}/jwt_encrypted_privatekey:${MEPAUTH_KEYS_DIR}/jwt_encrypted_privatekey:ro \
             -v ${MEP_CERTS_DIR}/mepserver_tls.crt:${MEPAUTH_SSL_DIR}/server.crt:ro \
             -v ${MEP_CERTS_DIR}/mepserver_tls.key:${MEPAUTH_SSL_DIR}/server.key:ro \
             -v ${MEP_CERTS_DIR}/ca.crt:${MEPAUTH_SSL_DIR}/ca.crt:ro \
             -v ${MEPAUTH_CONF_PATH}:/usr/mep/mepauth.properties \
             -e "MEPAUTH_APIGW_HOST=kong-service" \
             -e "MEPAUTH_APIGW_PORT=8444"  \
             -e "MEPAUTH_CERT_DOMAIN_NAME=${DOMAIN_NAME}" \
             edgegallery/mepauth:latest
```

MEP_CERTS_DIR is where you put mepauth server certificates and keys.
MEPAUTH_CONF_PATH is a config file for mepauth.

### run mepserver
MEP_CERTS_DIR is where you put mep server certificates and keys.
```
docker run -itd --name mepserver --network mep-net -e "SSL_ROOT=${MEPSERVER_SSL_DIR}" \
                                 --cap-drop All \
                                 -v ${MEP_CERTS_DIR}/mepserver_tls.crt:${MEPSERVER_SSL_DIR}/server.cer:ro \
                                 -v ${MEP_CERTS_DIR}/mepserver_encryptedtls.key:${MEPSERVER_SSL_DIR}/server_key.pem:ro \
                                 -v ${MEP_CERTS_DIR}/ca.crt:${MEPSERVER_SSL_DIR}/trust.cer:ro \
                                 -v ${MEP_CERTS_DIR}/mepserver_cert_pwd:${MEPSERVER_SSL_DIR}/cert_pwd:ro \
                                 edgegallery/mep:latest
```


More details about the building and installation of MEP, please refer to [HERE](https://gitee.com/edgegallery/docs/blob/master/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).

## Reference
[1] https://www.etsi.org/deliver/etsi_gs/MEC/001_099/003/02.01.01_60/gs_MEC003v020101p.pdf

[2] https://www.etsi.org/deliver/etsi_gs/MEC/001_099/011/01.01.01_60/gs_MEC011v010101p.pdf

[3] https://github.com/apache/servicecomb-service-center