
# Helm服务接入OSC平台
#### 前置条件
阅读本章节前，用户需要拥有一个符合Helm规范的服务包，Helm服务规范可以参考[Helm规范](https://support.huaweicloud.com/devg-osc/osc_ss_0016.html)，下面以helm开源服务grafana为例进行详细说明。
#### 接入流程
1. 用户参考附录[oscctl工具使用](https://support.huaweicloud.com/devg-osc/osc_ss_0051.html)中的链接下载oscctl工具oscctl-22.8.18.tar.gz，并放在linux执行机中。
2. 执行下面命令解压服务。 
   ```
   # 解压工具包
   $ tar -xvzf oscctl-22.8.18.tar.gz
   oscctl-22.8.18/
   oscctl-22.8.18/linux-x86_64/
   oscctl-22.8.18/linux-x86_64/oscctl
   oscctl-22.8.18/win-amd64/
   oscctl-22.8.18/win-amd64/oscctl.exe
   $ chmod +x oscctl-22.8.18/linux-x86_64/oscctl
   $ ./oscctl-22.8.18/linux-x86_64/oscctl convert -i grafana-5.5.7.tgz -o grafana-5.5.7.zip
   Successfully converted original package to OSC package!
   ```
   
   
3. 查看转换后的服务包结构。 
   ```
   grafana-5.5.7
   ├── lifecycle.yaml                 # operator生命周期文件，helm类型内容为空
   ├── manifests  
   │   ├── helmrelease_crd.yaml      # osc定义helm release的crd服务
   │   └── helmrelease_csd.yaml      # osc附加能力定义文件，需和crd文件联动使用
   ├── metadata.yaml
   └── raw                             # raw目录下存放的是原始的grafana helm包
       ├── Chart.yaml
       ├── templates
       │   ├── NOTES.txt
       │   ├── _helpers.tpl
       │   ├── deployment.yaml
       │   ├── hpa.yaml
       │   ├── ingress.yaml
       │   ├── service.yaml
       │   ├── serviceaccount.yaml
       │   └── tests
       │       └── test-connection.yaml
       ├── README.md    
       └── values.yaml
   ```
   
   
4. 生成的服务包如果需要配置OSC平台运维功能，请参考[对接运维能力(可选)](https://support.huaweicloud.com/devg-osc/osc_ss_0036.html)；如果不需要配置OSC平台运维功能，请直接查看《OSC服务使用者指南》了解如何上传服务包进行使用。
![](https://support.huaweicloud.com/devg-osc/public_sys-resources/note_3.0-zh-cn.png)
oscctl工具同样支持直接在windows平台上运行，需要使用windows终端进入，执行oscctl-22.8.18/win-amd64/oscctl.exe命令，参考上面的步骤操作即可。
