tnsmith/yottadb-golang

yottadb-golang 镜像文档

镜像概述

yottadb-golang 是一个集成了 YottaDB 数据库和 Go 语言环境的 Docker 镜像。YottaDB 是一款高性能、高可靠性的键值数据库，而 Go 语言以其高效、简洁的特性广泛用于后端开发。该镜像旨在为开发者提供一个开箱即用的环境，便于快速开发、测试和部署使用 Go 语言与 YottaDB 交互的应用程序。

核心功能与特性

• 预配置环境：已集成 YottaDB 数据库和 Go 语言运行时环境，无需手动安装配置
• 开发友好：包含必要的开发工具和依赖，支持 Go 语言应用与 YottaDB 的无缝集成
• 轻量级设计：基于精简基础镜像构建，减少资源占用
• 兼容性：支持主流的 Go 语言版本和 YottaDB 功能特性
• 可扩展性：可通过环境变量和配置文件自定义数据库参数和应用设置

使用场景

• Go 语言应用与 YottaDB 数据库交互的开发环境
• 快速原型验证和功能测试
• 小型应用的容器化部署
• 学习和研究 YottaDB 与 Go 语言结合的开发模式

使用方法

基本运行命令

bash
docker run -d --name yottadb-golang-app tnsmith/yottadb-golang

交互式运行

bash
docker run -it --name yottadb-golang-dev tnsmith/yottadb-golang /bin/bash

数据持久化

通过挂载数据卷保存 YottaDB 数据：

bash
docker run -d \
  --name yottadb-golang-persistent \
  -v /host/path/to/yottadb/data:/data/yottadb \
  tnsmith/yottadb-golang

环境变量配置

示例：指定自定义端口和项目路径

bash
docker run -d \
  --name yottadb-golang-custom \
  -e YOTTADB_PORT=23456 \
  -e GO_PROJECT_PATH=/go/src/myapp \
  -v /host/path/to/project:/go/src/myapp \
  tnsmith/yottadb-golang

与 Docker Compose 集成

创建 docker-compose.yml 文件：

yaml
version: '3'
services:
  yottadb-golang:
    image: tnsmith/yottadb-golang
    container_name: yottadb-golang-service
    ports:
      - "12345:12345"
    volumes:
      - ./yottadb-data:/data/yottadb
      - ./go-project:/go/src/app
    environment:
      - YOTTADB_REGION=MY_REGION
      - GO_PROJECT_PATH=/go/src/app
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 首次运行时，YottaDB 会初始化默认数据库配置
• 生产环境中建议使用数据卷持久化数据，避免容器重启导致数据丢失
• 可通过 docker exec -it <container_id> ydb 命令直接操作 YottaDB 数据库
• 如需自定义 Go 环境，可在容器内通过 go get 安装额外依赖包