kozea/python-node-yarn-postgresql

多环境集成Docker镜像文档

镜像概述

本镜像集成了Python 3.6/3.7、最新稳定版Node.js与Yarn包管理器，以及PostgreSQL 10数据库（含multicorn扩展），提供一站式多语言开发与运行时环境，简化需要多组件协同的应用部署流程。

核心功能与特性

1. 多版本Python支持

• 内置Python 3.6和3.7版本，可通过环境变量切换
• 包含pip包管理器，支持Python依赖安装

2. Node.js与前端工具链

• 集成最新稳定版Node.js
• 预装Yarn包管理器，支持高效前端依赖管理

3. PostgreSQL数据库环境

• 内置PostgreSQL 10数据库服务
• 预安装multicorn扩展（PostgreSQL外部数据包装器），支持连接外部数据源（如CSV、JSON、关系型数据库等）

使用场景

• 全栈开发环境：适用于同时涉及Python后端、Node.js前端及PostgreSQL数据库的全栈应用开发
• 多语言应用部署：支持需要Python和Node.js双语言运行时的应用部署
• 数据库扩展开发：利用multicorn扩展进行外部数据源集成开发与测试
• CI/CD流水线：作为统一的构建和测试环境，确保多组件依赖一致性

使用方法

基本启动命令

bash
docker run -d --name multi-env-container \
  -p 5432:5432 \  # 映射PostgreSQL端口
  -e POSTGRES_PASSWORD=mysecretpassword \  # 必选：设置PostgreSQL密码
  your-image-name:tag

环境变量配置

进入容器环境

bash
docker exec -it multi-env-container /bin/bash

进入容器后可直接使用以下命令：

• Python环境：python（或python3.6/python3.7）、pip
• Node.js环境：node、npm、yarn
• PostgreSQL客户端：psql -U $POSTGRES_USER -d $POSTGRES_DB

数据持久化配置

为避免容器重启导致PostgreSQL数据丢失，建议挂载数据卷：

bash
docker run -d --name multi-env-container \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v /host/path/to/postgres/data:/var/lib/postgresql/data \  # 挂载PostgreSQL数据目录
  your-image-name:tag

multicorn扩展使用示例

PostgreSQL已预装multicorn扩展，可通过以下步骤配置外部数据连接：

1. 进入PostgreSQL终端：

bash
psql -U postgres -d your_database

2. 启用multicorn扩展：

sql
CREATE EXTENSION multicorn;

3. 创建外部数据包装器（以CSV文件为例）：

sql
CREATE SERVER csv_server FOREIGN DATA WRAPPER multicorn 
OPTIONS (wrapper 'multicorn.csvfdw.CsvFdw');

CREATE FOREIGN TABLE csv_data (
  id INT,
  name TEXT,
  value FLOAT
) SERVER csv_server 
OPTIONS (filename '/path/to/data.csv', format 'csv', header 'true');

注意事项

• PostgreSQL服务默认在容器启动时自动启动，无需额外手动启动
• 生产环境建议通过-v参数挂载配置文件（如postgresql.conf）进行自定义配置
• 切换Python版本后需重启容器使配置生效