# manager-service

**Repository Path**: chz102/manager-service

## Basic Information

- **Project Name**: manager-service
- **Description**: This service is the management center of the Choerodon Microservices Framework. It`s main functions include configuration management, route management, and swagger management.
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2019-09-06
- **Last Updated**: 2021-11-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Manager Service

This service is the management center of the Choerodon Microservices Framework. It`s main functions include configuration management, route management, and swagger management.

## Installation and Getting Started

Create a `manager_service` database in MySQL：

```sql
CREATE USER 'choerodon'@'%' IDENTIFIED BY "123456";
CREATE DATABASE manager_service DEFAULT CHARACTER SET utf8;
GRANT ALL PRIVILEGES ON manager_service.* TO choerodon@'%';
FLUSH PRIVILEGES;
```
New file of `init-local-database.sh` in the root directory of the `manager-service` project：

```sh
mkdir -p target
if [ ! -f target/choerodon-tool-liquibase.jar ]
then
    curl http://nexus.choerodon.com.cn/repository/choerodon-release/io/choerodon/choerodon-tool-liquibase/0.6.0.RELEASE/choerodon-tool-liquibase-0.6.0.RELEASE.jar -o target/choerodon-tool-liquibase.jar
fi
java -Dspring.datasource.url="jdbc:mysql://localhost/manager_service?useUnicode=true&characterEncoding=utf-8&useSSL=false&useInformationSchema=true&remarks=true" \
 -Dspring.datasource.username=choerodon \
 -Dspring.datasource.password=123456 \
 -Ddata.drop=false -Ddata.init=true \
 -Ddata.dir=src/main/resources \
 -jar target/choerodon-tool-liquibase.jar
```

And executed in the root directory of the `manager-service` project：

```sh
sh init-local-database.sh
```
Then run the project in the root directory of the project：

```sh
mvn spring-boot:run
```

## Usage
1. Configuration management：
    * Manager provides configuration of new, update, and delete operations.
    * You can use the `json`, `yaml`, or `properties` text formats.
    * You can create or modify a configuration item for a version of a configuration.
    * After updating a configuration, the manager informs the `config-server` service and the corresponding service pulls the new configuration.
1. Route Management：
    * The initial route can be obtained by initializing the configuration of the `api-gateway` service.
    * You can create, edit, and edit routes.
    * After modifying the route, the manager will notify the `config-server` service and 
    
## Links

* [Change Log](./CHANGELOG.zh-CN.md)

## How to Contribute
Pull requests are welcome! Follow [this link](https://github.com/choerodon/choerodon/blob/master/CONTRIBUTING.md) for more information on how to contribute.