# 组件实例指引

> 该指引用于说明如何创建线上实例以及本地实例。

## 一、线上实例

> 注意事项：
>
> + 第一次启动实例后，“环境配置”内容修改无法生效
> + 如果需要修改已运行过实例的“环境配置”内容，需要删除该实例后，重新创建。

1. 前置准备

   在创建线上实例前，需要完成组件的开发、编译流程。

2. 创建“线上运行”实例

3. 修改“实例配置”以及“环境配置“

4. “启动”实例

## 二、本地实例

1. 前置准备

   在创建本地实例前，无需在平台完成组件的开发、编译等流程。

2. 创建“本地运行”实例

3. 打开“环境配置”，设置实例需要的环境配置，并复制对应本地运行命令（每一个实例本地运行命令不一样）

   > Java组件命令示例如下：
   >
   > java -Disdp.instance-id=demo_admin_ibasdj -Disdp.instance-name=demo -Disdp.component-id=1789897853057896449 -Disdp.nacos=127.0.0.1:8848 -Disdp.nacos-namespace=component -Disdp.ip=127.0.0.1 -jar app.jar

   > Python组件命令示例如下：
   >
   > python -u init.py '{"isdp.instance-id":"demo_py_admin_iwjofl","isdp.instance-name":"demo_py","isdp.component-id":"1789911618478411777","isdp.nacos":"127.0.0.1:8848","isdp.nacos-namespace":"component","isdp.ip":"127.0.0.1"}'

4. 本地启动

   ---

   + 命令行启动 Java组件
     + 通过源码编译启动
       1. 拉取项目
       2. 通过Maven编译项目
       3. 找到target目录下对应jar包
       4. `java -Disdp.instance-id=demo_admin_ibasdj -Disdp.instance-name=demo -Disdp.component-id=1789897853057896449 -Disdp.nacos=127.0.0.1:8848 -Disdp.nacos-namespace=component -Disdp.ip=127.0.0.1 -jar target/app.jar`
     + 通过jar包启动
       1. 下载jar包
       2.  `java -Disdp.instance-id=demo_admin_ibasdj -Disdp.instance-name=demo -Disdp.component-id=1789897853057896449 -Disdp.nacos=127.0.0.1:8848 -Disdp.nacos-namespace=component -Disdp.ip=127.0.0.1 -jar target/app.jar`

   ---

   + 命令行启动 Python 组件

     1. 拉取/下载项目
     2. `python -u init.py '{"isdp.instance-id":"demo_py_admin_iwjofl","isdp.instance-name":"demo_py","isdp.component-id":"1789911618478411777","isdp.nacos":"127.0.0.1:8848","isdp.nacos-namespace":"component","isdp.ip":"127.0.0.1"}'`

     ---

   + IDEA 启动 Java 组件

     1. 拉取项目源码

     2. 修改启动项（Edit Configuration）

     3. Add VM options

     4. 粘贴组件命令中 `-D` 部分（java  -Dxxx   -jar app.jar）

        > -Disdp.instance-id=demo_admin_ibasdj -Disdp.instance-name=demo -Disdp.component-id=1789897853057896449 -Disdp.nacos=127.0.0.1:8848 -Disdp.nacos-namespace=component -Disdp.ip=127.0.0.1

   + PyCharm 启动Python组件

     1. 拉取项目源码
     2. 打开Terminal终端
     3. 输入启动命令