# huaweicloud-solution-build-kefuIM  

**Repository Path**: HuaweiCloudDeveloper/huaweicloud-solution-build-kefu-im

## Basic Information

- **Project Name**: huaweicloud-solution-build-kefuIM  
- **Description**: 基于华为云应用编排一键安装部署雷鸣云客服IM系统，SAAS 客服IM的一键部署解决方案。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2022-08-31
- **Last Updated**: 2023-05-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 介绍
基于华为云应用编排一键安装部署雷鸣云客服IM系统，SAAS 客服IM的一键部署解决方案。

## 该解决方案有何用途？

该解决方案基于华为云服务器，帮助您快速部署您自己的SAAS客服IM系统。部署好后，可在线开通客服IM平台。所有操作过程全部无需任何后端技术人员及服务器运维人员参与。

#### 配置规格

搭配 1U2G 云服务器 + 1Mbit 带宽 + OBS

#### 适用场景

* 您是互联网公司，有如做网站、做APP、小程序等方面业务，都可以使用此来快速嵌入，让您的应用快速拥有IM客服的能力

## 方案架构

该解决方案可以帮助您在华为云弹性云服务器 Linux 操作系统中，快速搭建SAAS云客服系统环境，通过云上提供的OBS对象存储的无限存储及CDN无带宽上限的能力，用最低的费用，达到最快的响应及打开速度。

#### 架构描述

该解决方案部署如下资源：

1. 创建OBS对象存储桶，用来存储其中所上传的图片、附件等资源。
1. 创建弹性公网EIP，用于提供外部访问。
1. 创建安全组，可以保护后端云服务器的网络安全，通过配置安全组规则，限定云服务器的访问端口。
1. 创建[弹性云服务器](https://www.huaweicloud.com/product/ecs.html)，自动部署开源客服IM系统，提供SAAS云客服系统服务。


#### 方案优势

* 一台服务器承载成千上万个客服平台，不需再为每做一个客服IM就要单独付费或部署
* OBS对象存储，具备价格低、安全高、且随着网站及内容增加，具备无限扩容的能力
* 一键部署，15 分钟即可快速完成自有云上SAAS云客服平台构建。

## 目录及文件说明
* **main.tf** 资源编排文件，用于执行自动化部署操作 
* **user_data_install.sh** 创建服务器后，自动执行安装的shell命令
* **README.md** 说明文件  

## 本地开发调试

#### 1. 本地terraform环境
[安装Terraform](https://support.huaweicloud.com/qs-terraform/index.html) | 
[配置华为云 provider](https://support.huaweicloud.com/terraform_faq/index.html)

#### 2. 本地创建测试准备
创建一个新的目录并进入，然后执行以下进行拉取资源编排文件

````
# 下载编排文件
wget https://gitee.com/HuaweiCloudDeveloper/huaweicloud-solution-build-kefu-im/raw/master/PrimaryLevel/main.tf -O main.tf
````

#### 3. 设置环境变量
执行以下命令设置环境变量。  
HW_REGION_NAME默认cn-north-4就能运行起来，主要是要将 HW_ACCESS_KEY、HW_SECRET_KEY ，填上自己的

````
# HW_REGION_NAME：区域，即需要创建管理哪个区域的资源。
export HW_REGION_NAME="cn-north-4"

# HW_ACCESS_KEY：密钥ID，即AK。查询方法请参见 https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
export HW_ACCESS_KEY="my-access-key"

# HW_SECRET_KEY：访问密钥，即SK。查询方法请参见 https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html
export HW_SECRET_KEY="my-secret-key"
````

#### 4. 使用 main.tf 创建资源
按顺序逐个执行以下命令进行创建资源

````
terraform init
terraform plan
terraform apply
````

#### 5. 测试完释放资源，免得一直产生计费

````
terraform destroy 
````