octopusdeploy/docsync

Octofront与DocSync Docker镜像

镜像概述和主要用途

Octofront与DocSync Docker镜像组合用于在本地环境部署Octofront离线服务并同步博客仓库内容，实现博客修改的本地预览功能。通过Docker容器化部署，简化了本地开发环境配置，支持开发人员在离线状态下验证博客内容更改效果。

核心功能和特性

• 离线运行：支持Octofront服务本地离线部署，无需依赖外部服务
• 端口映射：提供44339（Web服务）和1433（数据库）端口映射
• 环境变量配置：支持通过环境变量设置Storyblok API令牌和数据库连接参数
• 文件同步：通过DocSync实现本地博客仓库与容器的文件同步
• 跨平台支持：提供Windows PowerShell和Linux/macOS两种环境的同步命令

使用场景和适用范围

适用于开发人员在本地修改博客内容后，需要快速预览更改效果的场景。特别适合OctopusDeploy博客仓库（https://github.com/OctopusDeploy/blog%EF%BC%89%E7%9A%84%E7%BB%B4%E6%8A%A4%E8%80%85%E8%BF%9B%E8%A1%8C%E5%86%85%E5%AE%B9%E7%BC%96%E8%BE%91%E5%92%8C%E9%AA%8C%E8%AF%81%E3%80%82

详细使用方法和配置说明

前提条件

• 已安装Docker Desktop（获取地址：[***]
• 拥有Docker Hub登录凭据（LastPass中名为"Docker local password (devopsatoctopus)"）
• 拥有Storyblok API令牌（LastPass中名为"Storyblok API Token - Dev"）
• 已克隆博客仓库到本地

安装与配置步骤

1. 安装Docker Desktop

从Docker官方文档下载并安装Docker Desktop：[***]

2. 登录Docker Hub

使用LastPass中的Docker凭据登录Docker Hub：

bash
docker login

3. 启动Octofront离线服务

将命令中的GetThisFromLastPass替换为LastPass中的Storyblok API令牌，执行以下命令启动Octofront容器：

bash
docker run -p 44339:44339 -p 1433:1433 -e octofront__contentManagement__storyblokToken=GetThisFromLastPass octopusdeploy/octofront

参数说明：

• -p 44339:44339：将容器的44339端口映射到本地44339端口（Web服务）
• -p 1433:1433：将容器的1433端口映射到本地1433端口（数据库服务）
• -e octofront__contentManagement__storyblokToken：设置Storyblok API令牌环境变量

4. 运行DocSync同步博客内容

在本地博客仓库目录中执行以下同步命令：

Windows (PowerShell)环境：

powershell
docker run -v "$(PWD):/blog" -e 'octofront__database=Server=host.docker.internal,1433;Database=Octofront;User Id=SA;Password=Password01!;Trust Server Certificate=True;' octopusdeploy/docsync --skipImages -r /blog --sync

Linux/macOS环境：

bash
docker run -v "${PWD}:/blog" -e 'octofront__database=Server=172.17.0.1,1433;Database=Octofront;User Id=SA;Password=Password01!;Trust Server Certificate=True;' octopusdeploy/docsync --skipImages -r /blog --sync

参数说明：

• -v "$(PWD):/blog"（Windows）或-v "${PWD}:/blog"（Linux/macOS）：将本地当前目录挂载到容器内的/blog目录
• -e octofront__database：设置数据库连接字符串环境变量
• --skipImages：跳过图片文件同步
• -r /blog：指定博客内容的根目录为/blog
• --sync：执行同步操作

5. 本地预览博客更改

同步完成后，通过浏览器访问以下地址查看本地博客更改： https://localhost:44339/blog