# macOS 部署指南

如果您的电脑为 macOS 操作系统,可以按照以下说明本地部署体验 Finclip 社区版。

# 1. 部署配置

我们建议您在 macOS 10.12 及以上系统版本中部署安装 FinClip 社区版。​

此外,系统的最低硬件要求如下表所示:

类目 最低要求
CPU 8 核
内存 8 GB(后台任务被清空) / 12G(后台有活动 IDE)
硬盘 50 GB
系统版本 macOS 10.12
软件 点击下载 Docker Desktop for Mac(Intel 芯片) (opens new window)
点击下载 Docker Desktop for Mac(Apple 芯片) (opens new window)

如果您使用的操作系统是 macOS ,但不清楚如何查看相关信息,您可以这样操作:​

在关于本机中查看

image.png

点击桌面左上角的 “ - 关于本机”,即可在“概览”中看到当前系统的版本,以及对应的 CPU 与内存信息,点击顶部的“储存空间”选项卡,即可查看当前电脑的硬盘信息及可用空间。​

此外,你也可以打开终端,并在其中输入 system_profiler SPHardwareDataType,从而查看当前的系统版本与硬件信息。

# 2. 社区版安装指引

# 2.1 安装 Docker

请注意

由于 Homebrew 方法在国内访问较慢,因此建议您通过手动下载安装方式,获取 Docker

手动下载安装

点击以下 这里 (opens new window) 下载 Docker Desktop for Mac,如果你的电脑搭载了 M1 芯片(arm64架构),请点击 这里 (opens new window) 下载。

如同 macOS 其它软件一样,安装也非常简单,双击下载的 .dmg 文件,然后将 Docker 的鲸鱼图标拖拽到 Application 文件夹即可(其间需要输入用户密码)。

image.png

使用 Homebrew 安装

如果你的电脑中已经安装了 Homebrew (opens new window),则可以直接通过 Homebrew 安装 Docker,请在终端中输入以下命令:

$ brew install --cask docker

# 2.2 下载部署文件

请分别下载以下三个文件:

请注意

您下载的配置文件保存的名字可能是 "env" , 需要修改名字为 ".env",macOS 系统下,以 "." 开头的文件默认是隐藏的,这个时候系统可能会提示您无法修改为以 "." 开头命名文件。​
参考 这个链接 (opens new window) 进行修改,或直接打开终端输入以下命令,回车执行后,就可以修改 env 文件名了。

defaults write com.apple.finder AppleShowAllFiles -boolean true ; killall Finder

修改环境变量

如果您希望修改部署后的 FinClip 社区版访问端口,以及对应的数据存放地址,可以修改 2.2 步骤中的 .env 文件,并修改其中的内容:

# common config   
BASE_STORAGE_DIR=./data                          
 # ↑ 代表于何处存放生成的数据
PORT=8000  
 # ↑ 请根据您的端口占用情况酌情配置此项               

# 2.3 加载镜像包

在 2.2 步骤中下载的配置文件所在目录,打开终端窗口并执行以下命令

如果您不知道如何在制定目录下打开终端,可以先通过 command+space 打开 聚焦搜索,并在其中输入 terminal.app,随后在命令行中输入“cd”,并将文件夹拖入终端窗口后回车即可。

docker load -i mop-20211122.gz

# 2.4 进行部署

请确保修改好的 .env 文件与 docker-compose.yaml 文件置于同一目录,并在当前目录下执行以下命令:

docker-compose up -d

当所有服务创建完成后,您会看到当前窗口如下图所示,也就代表着就部署完成了。

image.png

接下来,稍等一下,喝杯茶,当控制台上所有服务都是done的状态后,您需要额外稍等几分钟,等待服务初始化完成,即部署完成。

# 3. 登录使用

当部署完成后,请打开浏览器,并在地址栏中输入对应的地址。​

【企业端】请在浏览器地址栏中输入“http://127.0.0.1:8000/mop/mechanism/#/login (opens new window)”,如您是在部署远程服务器,则需要将“127.0.0.1”替换为对应的 IP 地址,如您在上文第三步修改了端口,则需要将“8000”替换为对应的端口号码。企业端主要用于小程序上下架,应用关联,SDK 集成。​

【运营端】请在浏览器地址栏中输入“http://127.0.0.1:8000/mop/operate/#/login (opens new window)”,如您是在部署远程服务器,则需要将“127.0.0.1”替换为对应的 IP 地址,如您在上文第三步修改了端口,则需要将“8000”替换为对应的端口号码。运营端主要用于小程序审核,成员管理。​

登录企业端与运营端的默认用户名为“finclip@finogeeks.com”,密码为“123Abc”​

想了解企业端与运营端更多的实际操作指引,请点击企业端操作指引 (opens new window),或运营端操作指引 (opens new window)

# 4. 常见问题

Q1:在执行部署命令 docker-compose up -d 时,报错 Cannot start service xxx...

具体报错内容如下图:

image.png

报错原因:

可能是您下载配置文件的地址,Docker 没有访问权限,您可以按照提示修改 Docker 的文件共享目录,或者将配置文件拷贝到 Docker 有权限访问的文件目录下。​

Q2:在执行部署命令docker-compose up -d时,报错...variable is not set. Defaulting to a blank string.

具体报错内容如下图:

image.png

报错原因:

读取配置文件 docker-compose.yaml,无法读取到配置信息中设置的变量的值,变量值是在env文件中,您检查看是否 ENV 文件的命名是否没有以 "." 开头的,这种情况下需要修改文件名为 ".env"​

© 2021 凡泰极客
  • 免费试用
  • 编组
  • 编组 2