sward入门指南(1) - 安装部署

DevOps实践之道
307 阅读4分钟

sward是一个开源免费的项目管理软件，之前简单介绍过它的功能，今天来介绍一下私有部署版本的安装与配置。

1. 安装

下面介绍一下Linux安装，Docker安装，Windows安装,Mac安装

1.1 Linux 安装

wget -O tiklab-sward-2.0.7.deb https://install.tiklab.net/app/install/sward/2.0.7/tiklab-sward-2.0.7.deb
  • 安装，执行以下命令安装，默认安装在opt 目录下
 dpkg -i tiklab-sward-2.0.7.deb
  • 启动，安装之后，在opt目录下会出现一个名字为 tiklab-sward的文件夹，tiklab-sward的文件夹下的bin文件夹，执行 ./sward start 命令，启动项目
    cd opt/tiklab-sward/bin
    ./sward start

1.2 Docker 安装

wget -O tiklab-sward-2.0.7.tar.gz https://install.tiklab.net/app/install/sward/2.0.7/tiklab-sward-2.0.7.tar.gz
  • 安装，执行以下命令加载镜像
docker load -i tiklab-sward-2.0.7.tar.gz
  • 启动，完成后，执行以下命令启动镜像
docker run -itd -p 9600:9600 tiklab-sward:2.0.7

1.3 Windows 安装

  • 下载，下载Windows安装包
  • 安装，双击安装包后，依次点击下一步->安装->完成
  • 启动，sward安装成功后会弹出启动页面，点击启用应用

1.4 Mac 安装

  • 下载，下载Mac安装包
  • 安装，下载完成后会得到tiklab-sward-2.0.7.dmg格式类似的可执行文件，双击可执行文件 --> 将tiklab-sward-2.0.7.app拉入应用程序中即可
  • 启动，安装完成之后再启动图出现sward图标，点击图标启动

2. 登录

在浏览器输入http://ip:9600 访问系统，默认使用本地登录模式，默认登录帐号密码为admin/123456。

项目首页：

image.png

3. 自定义配置

sward 私有部署版本可以对数据库，启动端口、数据存放地址、dcs（缓存配置），dfs(附件存储），备份，登录地址这些参数进行配置

下表展示自定义配置文件的地址：

系统默认位置
Windows默认在安装目录 --> conf -> application.yaml 目录下
Mac默认在app下的Contents --> conf -> application.yaml 目录下
Linux默认在/opt/tiklab-sward/conf/ application.yaml 目录下
Docker默认在镜像文件内/usr/local/tiklab-sward/conf/application.yaml 目录下

3.1 启动端口

应用启动端口可自定义，默认为9600，可以修改为其他端口；

# 端口
server:
    port: 9600
属性值
server.port系统启动的端口号（可更改）

3.2 数据库

数据库需要在jdbc 和 postgresql 两个部分修改，可以修改数据库地址与端口，账号与密码要改成相应的，数据库端口必须一致

postgresql:
  embbed:
    enable: true
  database: tiklab_sward
  db:
    port: 9601
    username: postgres
    password: darth2020
    address: ${DATA_HOME}/postgresql

jdbc:
  driverClassName: org.postgresql.Driver
  url: jdbc:postgresql://localhost:9601/tiklab_sward?stringtype=unspecified
  username: postgres
  password: darth2020
属性说明
postgresql.embbed.enable是否使用内嵌数据库，true:使用 false:不使用。如果配置为false，需要把该文件中jdbc下的数据库连接信息更改为自己的数据库地址，用户名以及密码。
postgresql.database是否使用内嵌数据库默认连接的数据库，默认为matflow-ee如果更改次默认值需要把jdbc下的数据库连接信息更改为新的数据地址。
postgresql.db.port使用内嵌数据库的启动端口，默认为9201，如果更改需要同时把jdbc.url中的数据库连接地址端口更改。
postgresql.db.username使用内嵌数据库的用户名，默认为postgres，如果更改需要同时把jdbc.username中的数据库连接地址用户名更改。
postgresql.db.password使用内嵌数据库的密码，默认为darth2020，如果更改需要同时把jdbc.password中的数据库连接地址密码更改。
postgresql.db.address使用内嵌数据库的数据库文件保存位置，默认为${DATA_HOME}/postgresql，即默认的应用数据目录下的postgresql目录。注：如果更改该目录，该路径目录必须为空目录，否则会导致数据库无法启动。
jdbc.url默认是：jdbc:postgresql://localhost:9601/sward_ee?stringtype=unspecified其中 9601 为端口号，sward_ee 为数据库名字，这两个可更改但是端口号必须与postgresql.db.port 保持一致数据库名字必须与postgresql.database 保持一致
jdbc.username数据库登录名，必须与postgresql.db.username一致
jdbc.password数据库登录密码，必须与postgresql.db.password一致

3.4 数据存储

DATA_HOME为数据文件存放地址。

属性值
系统数据文件存放地址
WindowsC:\tiklab\tiklab-sward
Linux/opt/tiklab/tiklab-sward
Mac/Applications/tiklab/tiklab-sward
Docker/opt/tiklab/tiklab-sward

3.3 统一登录

统一登录，即使用统一使用Soular的用户，部门等，这样配置可以让一个用户同时使用多个应用。需要安装Soular，具体安装见Soular 文档。

#soular  
auth:  
  type: local  
  soular:  
    address: http://soular.tiklab.net  
  expire: 86400
属性说明
typelocal:本地登录 soular:统一登录。配置文件中默认为local
address配置统一登录时需更改address为soular地址，http://ip:9100， IP为安装soular的机器IP

4. 更新

Sward支持用户使用脚本一键升级，只需要执行应用升级脚本即可。

Sward的升级脚本位置：

系统默认位置
Linux执行swardctl update脚本。

5. 帮助与支持

tiklab提供了详细的使用文档，你也可以随时向活跃的社区寻求帮助！

sward下载：download.tiklab.net/sward

sward使用文档：doc.tiklab.net/document/23…

tiklab社区：developer.tiklab.net/

avatar
文章
阅读
粉丝