feat: allow to set sourceRegistry by CNPMCORE_CONFIG_SOURCE_REGISTRY (#753)

Improve the local development process based on docker-compose  ## Summary by CodeRabbit - **New Features** - Introduced a centralized configuration utility that validates environment variable types and provides fallback defaults. - **Refactor** - Standardized environment variable handling across configuration files, improving maintainability and consistency in system setup.
2025-02-09 11:15:28 +08:00
parent aba2b36291
commit 9f4f1f1e28
11 changed files with 254 additions and 98 deletions
--- a/.env.example
+++ b/.env.example
@@ -0,0 +1,9 @@
+# CNPMCORE_DATABASE_TYPE=MySQL
+# CNPMCORE_DATABASE_USER=root
+# CNPMCORE_DATABASE_PASSWORD=
+# CNPMCORE_DATABASE_NAME=cnpmcore
+
+# CNPMCORE_DATABASE_TYPE=PostgreSQL
+# CNPMCORE_DATABASE_USER=postgres
+# CNPMCORE_DATABASE_PASSWORD=postgres
+# CNPMCORE_DATABASE_NAME=cnpmcore
--- a/DEVELOPER.md
+++ b/DEVELOPER.md
@@ -4,14 +4,32 @@

 本项目的外部服务依赖有：MySQL 数据库或 PostgreSQL 数据库、Redis 缓存服务。

-可以通过 Docker 来快速启动本地开发环境：
+生成本地开发环境配置文件：

 ```bash
-# 启动本地依赖服务
-docker-compose up -d
+cp .env.example .env
+```
+
+可以通过 Docker 来快速启动本地开发环境：
+
+MySQL 开发环境：
+
+```bash
+# 启动本地依赖服务 - MySQL + Redis
+docker-compose -f docker-compose.yml up -d

 # 关闭本地依赖服务
-docker-compose down
+docker-compose -f docker-compose.yml down
+```
+
+PostgreSQL 开发环境：
+
+```bash
+# 启动本地依赖服务 - PostgreSQL + Redis
+docker-compose -f docker-compose-postgres.yml up -d
+
+# 关闭本地依赖服务
+docker-compose -f docker-compose-postgres.yml down
 ```

 > 手动初始化依赖服务参见[本地开发环境 - MySQL](./docs/setup.md) 或 [本地开发环境 - PostgreSQL](./docs/setup-with-postgresql.md)
@@ -35,6 +53,9 @@ npm run dev

 # 访问
 curl -v http://127.0.0.1:7001
+
+# cnpmcore_admin 注册管理员
+npm login --registry=http://127.0.0.1:7001
 ```

 ### 开发运行 - PostgreSQL
@@ -50,6 +71,23 @@ npm run dev:postgresql
 curl -v http://127.0.0.1:7001
 ```

+### 登录和测试发包
+
+注册 cnpmcore_admin 管理员
+
+```bash
+npm login --registry=http://127.0.0.1:7001
+
+# 验证登录
+npm whoami --registry=http://127.0.0.1:7001
+```
+
+发包
+
+```bash
+npm publish --registry=http://127.0.0.1:7001
+```
+
 ### 单元测试

 MySQL
--- a/app/common/EnvUtil.ts
+++ b/app/common/EnvUtil.ts
@@ -0,0 +1,37 @@
+export type ValueType = 'string' | 'boolean' | 'number';
+
+export function env(key: string, valueType: ValueType, defaultValue: string): string;
+export function env(key: string, valueType: ValueType, defaultValue: boolean): boolean;
+export function env(key: string, valueType: ValueType, defaultValue: number): number;
+export function env(key: string, valueType: ValueType, defaultValue: string | boolean | number): string | boolean | number {
+  const value = process.env[key];
+  if (value === undefined) {
+    return defaultValue;
+  }
+
+  if (valueType === 'string') {
+    return value;
+  }
+
+  if (valueType === 'boolean') {
+    let booleanValue = false;
+    if (value === 'true' || value === '1') {
+      booleanValue = true;
+    } else if (value === 'false' || value === '0') {
+      booleanValue = false;
+    } else {
+      throw new TypeError(`Invalid boolean value: ${value} on process.env.${key}`);
+    }
+    return booleanValue;
+  }
+
+  if (valueType === 'number') {
+    const numberValue = Number(value);
+    if (isNaN(numberValue)) {
+      throw new TypeError(`Invalid number value: ${value} on process.env.${key}`);
+    }
+    return numberValue;
+  }
+
+  throw new TypeError(`Invalid value type: ${valueType}`);
+}
--- a/config/config.default.ts
+++ b/config/config.default.ts
@@ -1,10 +1,11 @@
 import { strict as assert } from 'node:assert';
 import { randomUUID } from 'node:crypto';
 import { join } from 'node:path';
-import { EggAppConfig, PowerPartial } from 'egg';
+import { EggAppConfig, PowerPartial, Context } from 'egg';
 import OSSClient from 'oss-cnpm';
 import { patchAjv } from '../app/port/typebox';
 import { ChangesStreamMode, NOT_IMPLEMENTED_PATH, SyncDeleteMode, SyncMode } from '../app/common/constants';
+import { env } from '../app/common/EnvUtil';
 import type { CnpmcoreConfig } from '../app/port/config';
 import { database } from './database';

@@ -12,8 +13,8 @@ export const cnpmcoreConfig: CnpmcoreConfig = {
  name: 'cnpm',
  hookEnable: false,
  hooksLimit: 20,
-  sourceRegistry: 'https://registry.npmjs.org',
-  sourceRegistryIsCNpm: false,
+  sourceRegistry: env('CNPMCORE_CONFIG_SOURCE_REGISTRY', 'string', 'https://registry.npmjs.org'),
+  sourceRegistryIsCNpm: env('CNPMCORE_CONFIG_SOURCE_REGISTRY_IS_CNPM', 'boolean', false),
  syncUpstreamFirst: false,
  sourceRegistrySyncTimeout: 180000,
  taskQueueHighWaterSize: 100,
@@ -33,7 +34,7 @@ export const cnpmcoreConfig: CnpmcoreConfig = {
  checkChangesStreamInterval: 500,
  changesStreamRegistry: 'https://replicate.npmjs.com',
  changesStreamRegistryMode: ChangesStreamMode.streaming,
-  registry: process.env.CNPMCORE_CONFIG_REGISTRY || 'http://localhost:7001',
+  registry: env('CNPMCORE_CONFIG_REGISTRY', 'string', 'http://localhost:7001'),
  alwaysAuth: false,
  allowScopes: [
    '@cnpm',
@@ -45,7 +46,7 @@ export const cnpmcoreConfig: CnpmcoreConfig = {
  admins: {
    cnpmcore_admin: 'admin@cnpmjs.org',
  },
-  enableWebAuthn: !!process.env.CNPMCORE_CONFIG_ENABLE_WEB_AUTHN,
+  enableWebAuthn: env('CNPMCORE_CONFIG_ENABLE_WEB_AUTHN', 'boolean', false),
  enableCDN: false,
  cdnCacheControlHeader: 'public, max-age=300',
  cdnVaryHeader: 'Accept, Accept-Encoding',
@@ -57,7 +58,7 @@ export const cnpmcoreConfig: CnpmcoreConfig = {
  enableSyncUnpkgFiles: true,
  enableSyncUnpkgFilesWhiteList: false,
  strictSyncSpecivicVersion: false,
-  enableElasticsearch: !!process.env.CNPMCORE_CONFIG_ENABLE_ES,
+  enableElasticsearch: env('CNPMCORE_CONFIG_ENABLE_ES', 'boolean', false),
  elasticsearchIndex: 'cnpmcore_packages',
  strictValidateTarballPkg: false,
  strictValidatePackageDeps: false,
@@ -69,14 +70,14 @@ export const cnpmcoreConfig: CnpmcoreConfig = {
 export default (appInfo: EggAppConfig) => {
  const config = {} as PowerPartial<EggAppConfig>;

-  config.keys = process.env.CNPMCORE_EGG_KEYS || randomUUID();
+  config.keys = env('CNPMCORE_EGG_KEYS', 'string', randomUUID());
  config.cnpmcore = cnpmcoreConfig;

  // override config from framework / plugin
-  config.dataDir = process.env.CNPMCORE_DATA_DIR || join(appInfo.root, '.cnpmcore');
+  config.dataDir = env('CNPMCORE_DATA_DIR', 'string', join(appInfo.root, '.cnpmcore'));
  config.orm = {
    ...database,
-    database: database.name ?? 'cnpmcore',
+    database: database.name || 'cnpmcore',
    charset: 'utf8mb4',
    logger: {
      // https://github.com/cyjake/leoric/blob/master/docs/zh/logging.md#logqueryerror
@@ -90,10 +91,10 @@ export default (appInfo: EggAppConfig) => {

  config.redis = {
    client: {
-      port: Number(process.env.CNPMCORE_REDIS_PORT || 6379),
-      host: process.env.CNPMCORE_REDIS_HOST || '127.0.0.1',
-      password: process.env.CNPMCORE_REDIS_PASSWORD || '',
-      db: Number(process.env.CNPMCORE_REDIS_DB || 0),
+      port: env('CNPMCORE_REDIS_PORT', 'number', 6379),
+      host: env('CNPMCORE_REDIS_HOST', 'string', '127.0.0.1'),
+      password: env('CNPMCORE_REDIS_PASSWORD', 'string', ''),
+      db: env('CNPMCORE_REDIS_DB', 'number', 0),
    },
  };

@@ -105,7 +106,7 @@ export default (appInfo: EggAppConfig) => {

  config.cors = {
    // allow all domains
-    origin: (ctx): string => {
+    origin: (ctx: Context): string => {
      return ctx.get('Origin');
    },
    credentials: true,
@@ -115,59 +116,61 @@ export default (appInfo: EggAppConfig) => {

  config.nfs = {
    client: null,
-    dir: process.env.CNPMCORE_NFS_DIR || join(config.dataDir, 'nfs'),
+    dir: env('CNPMCORE_NFS_DIR', 'string', join(config.dataDir, 'nfs')),
  };
  /* c8 ignore next 17 */
  // enable oss nfs store by env values
-  if (process.env.CNPMCORE_NFS_TYPE === 'oss') {
-    assert(process.env.CNPMCORE_NFS_OSS_BUCKET, 'require env CNPMCORE_NFS_OSS_BUCKET');
-    assert(process.env.CNPMCORE_NFS_OSS_ENDPOINT, 'require env CNPMCORE_NFS_OSS_ENDPOINT');
-    assert(process.env.CNPMCORE_NFS_OSS_ID, 'require env CNPMCORE_NFS_OSS_ID');
-    assert(process.env.CNPMCORE_NFS_OSS_SECRET, 'require env CNPMCORE_NFS_OSS_SECRET');
-    config.nfs.client = new OSSClient({
-      cdnBaseUrl: process.env.CNPMCORE_NFS_OSS_CDN,
-      endpoint: process.env.CNPMCORE_NFS_OSS_ENDPOINT,
-      bucket: process.env.CNPMCORE_NFS_OSS_BUCKET,
-      accessKeyId: process.env.CNPMCORE_NFS_OSS_ID,
-      accessKeySecret: process.env.CNPMCORE_NFS_OSS_SECRET,
+  const nfsType = env('CNPMCORE_NFS_TYPE', 'string', '');
+  if (nfsType === 'oss') {
+    const ossConfig = {
+      cdnBaseUrl: env('CNPMCORE_NFS_OSS_CDN', 'string', ''),
+      endpoint: env('CNPMCORE_NFS_OSS_ENDPOINT', 'string', ''),
+      bucket: env('CNPMCORE_NFS_OSS_BUCKET', 'string', ''),
+      accessKeyId: env('CNPMCORE_NFS_OSS_ID', 'string', ''),
+      accessKeySecret: env('CNPMCORE_NFS_OSS_SECRET', 'string', ''),
      defaultHeaders: {
        'Cache-Control': 'max-age=0, s-maxage=60',
      },
-    });
-  } else if (process.env.CNPMCORE_NFS_TYPE === 's3') {
-    assert(process.env.CNPMCORE_NFS_S3_CLIENT_ENDPOINT, 'require env CNPMCORE_NFS_S3_CLIENT_ENDPOINT');
-    assert(process.env.CNPMCORE_NFS_S3_CLIENT_ID, 'require env CNPMCORE_NFS_S3_CLIENT_ID');
-    assert(process.env.CNPMCORE_NFS_S3_CLIENT_SECRET, 'require env CNPMCORE_NFS_S3_CLIENT_SECRET');
-    assert(process.env.CNPMCORE_NFS_S3_CLIENT_BUCKET, 'require env CNPMCORE_NFS_S3_CLIENT_BUCKET');
+    };
+    assert(ossConfig.cdnBaseUrl, 'require env CNPMCORE_NFS_OSS_BUCKET');
+    assert(ossConfig.endpoint, 'require env CNPMCORE_NFS_OSS_ENDPOINT');
+    assert(ossConfig.accessKeyId, 'require env CNPMCORE_NFS_OSS_ID');
+    assert(ossConfig.accessKeySecret, 'require env CNPMCORE_NFS_OSS_SECRET');
+    config.nfs.client = new OSSClient(ossConfig);
+  } else if (nfsType === 's3') {
+    const s3Config = {
+      region: env('CNPMCORE_NFS_S3_CLIENT_REGION', 'string', 'default'),
+      endpoint: env('CNPMCORE_NFS_S3_CLIENT_ENDPOINT', 'string', ''),
+      credentials: {
+        accessKeyId: env('CNPMCORE_NFS_S3_CLIENT_ID', 'string', ''),
+        secretAccessKey: env('CNPMCORE_NFS_S3_CLIENT_SECRET', 'string', ''),
+      },
+      bucket: env('CNPMCORE_NFS_S3_CLIENT_BUCKET', 'string', ''),
+      forcePathStyle: env('CNPMCORE_NFS_S3_CLIENT_FORCE_PATH_STYLE', 'boolean', false),
+      disableURL: env('CNPMCORE_NFS_S3_CLIENT_DISABLE_URL', 'boolean', false),
+    };
+    assert(s3Config.endpoint, 'require env CNPMCORE_NFS_S3_CLIENT_ENDPOINT');
+    assert(s3Config.credentials.accessKeyId, 'require env CNPMCORE_NFS_S3_CLIENT_ID');
+    assert(s3Config.credentials.secretAccessKey, 'require env CNPMCORE_NFS_S3_CLIENT_SECRET');
+    assert(s3Config.bucket, 'require env CNPMCORE_NFS_S3_CLIENT_BUCKET');
+    // TODO(@fengmk2): should change to use import to support esm
    // eslint-disable-next-line @typescript-eslint/no-var-requires
    const S3Client = require('s3-cnpmcore');
-    config.nfs.client = new S3Client({
-      region: process.env.CNPMCORE_NFS_S3_CLIENT_REGION || 'default',
-      endpoint: process.env.CNPMCORE_NFS_S3_CLIENT_ENDPOINT,
-      credentials: {
-        accessKeyId: process.env.CNPMCORE_NFS_S3_CLIENT_ID,
-        secretAccessKey: process.env.CNPMCORE_NFS_S3_CLIENT_SECRET,
-      },
-      bucket: process.env.CNPMCORE_NFS_S3_CLIENT_BUCKET,
-      forcePathStyle: !!process.env.CNPMCORE_NFS_S3_CLIENT_FORCE_PATH_STYLE,
-      disableURL: !!process.env.CNPMCORE_NFS_S3_CLIENT_DISABLE_URL,
-    });
+    config.nfs.client = new S3Client(s3Config);
  }

  config.logger = {
    enablePerformanceTimer: true,
    enableFastContextLogger: true,
-    appLogName: process.env.CNPMCORE_APP_LOG_NAME || `${appInfo.name}-web.log`,
-    coreLogName: process.env.CNPMCORE_CORE_LOG_NAME || 'egg-web.log',
-    agentLogName: process.env.CNPMCORE_AGENT_LOG_NAME || 'egg-agent.log',
-    errorLogName: process.env.CNPMCORE_ERROR_LOG_NAME || 'common-error.log',
-    outputJSON: Boolean(process.env.CNPMCORE_LOG_JSON_OUTPUT || false),
+    appLogName: env('CNPMCORE_APP_LOG_NAME', 'string', `${appInfo.name}-web.log`),
+    coreLogName: env('CNPMCORE_CORE_LOG_NAME', 'string', 'egg-web.log'),
+    agentLogName: env('CNPMCORE_AGENT_LOG_NAME', 'string', 'egg-agent.log'),
+    errorLogName: env('CNPMCORE_ERROR_LOG_NAME', 'string', 'common-error.log'),
+    outputJSON: env('CNPMCORE_LOG_JSON_OUTPUT', 'boolean', false),
  };
-  if (process.env.CNPMCORE_LOG_DIR) {
-    config.logger.dir = process.env.CNPMCORE_LOG_DIR;
-  }
-  if (process.env.CNPMCORE_LOG_JSON_OUTPUT) {
-    config.logger.outputJSON = Boolean(process.env.CNPMCORE_LOG_JSON_OUTPUT);
+  const logDir = env('CNPMCORE_LOG_DIR', 'string', '');
+  if (logDir) {
+    config.logger.dir = logDir;
  }

  config.logrotator = {
@@ -207,10 +210,10 @@ export default (appInfo: EggAppConfig) => {
  if (config.cnpmcore.enableElasticsearch) {
    config.elasticsearch = {
      client: {
-        node: process.env.CNPMCORE_CONFIG_ES_CLIENT_NODE,
+        node: env('CNPMCORE_CONFIG_ES_CLIENT_NODE', 'string', ''),
        auth: {
-          username: process.env.CNPMCORE_CONFIG_ES_CLIENT_AUTH_USERNAME as string,
-          password: process.env.CNPMCORE_CONFIG_ES_CLIENT_AUTH_PASSWORD as string,
+          username: env('CNPMCORE_CONFIG_ES_CLIENT_AUTH_USERNAME', 'string', ''),
+          password: env('CNPMCORE_CONFIG_ES_CLIENT_AUTH_PASSWORD', 'string', ''),
        },
      },
    };
@@ -218,3 +221,4 @@ export default (appInfo: EggAppConfig) => {

  return config;
 };
+
--- a/config/config.unittest.ts
+++ b/config/config.unittest.ts
@@ -10,7 +10,7 @@ export default (appInfo: EggAppConfig) => {
  config.dataDir = join(appInfo.root, '.cnpmcore_unittest');

  config.orm = {
-    database: database.name ?? 'cnpmcore_unittest',
+    database: database.name || 'cnpmcore_unittest',
  };

  config.nfs = {
--- a/config/database.ts
+++ b/config/database.ts
@@ -1,33 +1,35 @@
+import { env } from '../app/common/EnvUtil';
+
 export enum DATABASE_TYPE {
  MySQL = 'MySQL',
  PostgreSQL = 'PostgreSQL',
  SQLite = 'SQLite',
 }

-const dbType = process.env.CNPMCORE_DATABASE_TYPE ?? DATABASE_TYPE.MySQL;
-let dbName = process.env.CNPMCORE_DATABASE_NAME;
-let dbHost = process.env.CNPMCORE_DATABASE_HOST;
-let dbPort = process.env.CNPMCORE_DATABASE_PORT;
-let dbUser = process.env.CNPMCORE_DATABASE_USER;
-let dbPassword = process.env.CNPMCORE_DATABASE_PASSWORD;
+const dbType = env('CNPMCORE_DATABASE_TYPE', 'string', DATABASE_TYPE.MySQL);
+let dbName = env('CNPMCORE_DATABASE_NAME', 'string', '');
+let dbHost = env('CNPMCORE_DATABASE_HOST', 'string', '');
+let dbPort = env('CNPMCORE_DATABASE_PORT', 'number', 0);
+let dbUser = env('CNPMCORE_DATABASE_USER', 'string', '');
+let dbPassword = env('CNPMCORE_DATABASE_PASSWORD', 'string', '');
 let dialect = 'mysql';
 let dbClient = 'mysql2';
 if (dbType === DATABASE_TYPE.MySQL) {
  // Compatible mysql configurations
-  dbName = dbName ?? process.env.CNPMCORE_MYSQL_DATABASE ?? process.env.MYSQL_DATABASE;
-  dbHost = dbHost ?? process.env.CNPMCORE_MYSQL_HOST ?? process.env.MYSQL_HOST ?? '127.0.0.1';
-  dbPort = dbPort ?? process.env.CNPMCORE_MYSQL_PORT ?? process.env.MYSQL_PORT ?? '3306';
-  dbUser = dbUser ?? process.env.CNPMCORE_MYSQL_USER ?? process.env.MYSQL_USER ?? 'root';
-  dbPassword = dbPassword ?? process.env.CNPMCORE_MYSQL_PASSWORD ?? process.env.MYSQL_PASSWORD;
+  dbName = dbName || env('CNPMCORE_MYSQL_DATABASE', 'string', '') || env('MYSQL_DATABASE', 'string', '') || '';
+  dbHost = dbHost || env('CNPMCORE_MYSQL_HOST', 'string', '') || env('MYSQL_HOST', 'string', '') || '127.0.0.1';
+  dbPort = dbPort || env('CNPMCORE_MYSQL_PORT', 'number', 0) || env('MYSQL_PORT', 'number', 0) || 3306;
+  dbUser = dbUser || env('CNPMCORE_MYSQL_USER', 'string', '') || env('MYSQL_USER', 'string', '') || 'root';
+  dbPassword = dbPassword || env('CNPMCORE_MYSQL_PASSWORD', 'string', '') || env('MYSQL_PASSWORD', 'string', '');
 } else if (dbType === DATABASE_TYPE.PostgreSQL) {
  dbClient = 'pg';
  dialect = 'postgres';
-  dbHost = dbHost ?? process.env.CNPMCORE_POSTGRES_HOST ?? process.env.POSTGRES_HOST;
-  dbPort = dbPort ?? process.env.CNPMCORE_POSTGRES_PORT ?? process.env.POSTGRES_PORT ?? '5432';
-  dbUser = dbUser ?? process.env.CNPMCORE_POSTGRES_USER ?? process.env.POSTGRES_USER;
-  dbPassword = dbPassword ?? process.env.CNPMCORE_POSTGRES_PASSWORD ?? process.env.POSTGRES_PASSWORD;
+  dbHost = dbHost || env('CNPMCORE_POSTGRES_HOST', 'string', '') || env('POSTGRES_HOST', 'string', '') || '127.0.0.1';
+  dbPort = dbPort || env('CNPMCORE_POSTGRES_PORT', 'number', 0) || env('POSTGRES_PORT', 'number', 0) || 5432;
+  dbUser = dbUser || env('CNPMCORE_POSTGRES_USER', 'string', '') || env('POSTGRES_USER', 'string', '') || 'postgres';
+  dbPassword = dbPassword || env('CNPMCORE_POSTGRES_PASSWORD', 'string', '') || env('POSTGRES_PASSWORD', 'string', '') || 'postgres';
 } else if (dbType === DATABASE_TYPE.SQLite) {
-  // TODO
+  // TODO: Implement SQLite
  dbClient = 'sqlite';
  dialect = 'sqlite';
 }
--- a/docker-compose-postgres.yml
+++ b/docker-compose-postgres.yml
@@ -0,0 +1,61 @@
+name: cnpmcore_dev_services_postgres
+
+services:
+  redis:
+    env_file:
+      - .env
+    image: redis:6-alpine
+    # command: redis-server --appendonly yes --requirepass cnpm
+    restart: always
+    volumes:
+      - cnpm-redis:/data
+    ports:
+      - 6379:6379
+    networks:
+      - cnpm-postgres
+
+  postgres:
+    env_file:
+      - .env
+    image: postgres:17
+    restart: always
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+    ports:
+      - 5432:5432
+    networks:
+      - cnpm-postgres
+    volumes:
+      - cnpm-postgres:/var/lib/postgresql/data
+
+  # https://github.com/khezen/compose-postgres/blob/master/docker-compose.yml
+  pgadmin:
+    env_file:
+      - .env
+    image: dpage/pgadmin4
+    restart: always
+    environment:
+      POSTGRES_USER: ${POSTGRES_USER:-postgres}
+      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-postgres}
+      PGADMIN_DEFAULT_EMAIL: ${PGADMIN_DEFAULT_EMAIL:-pgadmin4@pgadmin.org}
+      PGADMIN_DEFAULT_PASSWORD: ${PGADMIN_DEFAULT_PASSWORD:-admin}
+      PGADMIN_CONFIG_SERVER_MODE: 'False'
+    volumes:
+      - cnpm-pgadmin:/var/lib/pgadmin
+    ports:
+      - 8888:80
+    networks:
+      - cnpm-postgres
+    depends_on:
+      - postgres
+
+volumes:
+  cnpm-redis:
+  cnpm-postgres:
+  cnpm-pgadmin:
+
+networks:
+  cnpm-postgres:
+    name: cnpm-postgres
+    driver: bridge
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,6 +1,9 @@
-version: '3.6'
+name: cnpmcore_dev_services_mysql
+
 services:
  redis:
+    env_file:
+      - .env
    image: redis:6-alpine
    # command: redis-server --appendonly yes --requirepass cnpm
    restart: always
@@ -9,41 +12,42 @@ services:
    ports:
      - 6379:6379
    networks:
-      - cnpm
+      - cnpm-mysql

  mysql:
-    image: mariadb
+    env_file:
+      - .env
+    image: mysql:9
    command: --character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci
    restart: always
    environment:
-      MYSQL_ROOT_PASSWORD:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-}
      MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
-      # MYSQL_DATABASE: 'cnpmcore_unittest'
-      MYSQL_USER: user
-      MYSQL_PASSWORD: pass
+      MYSQL_DATABASE: ${MYSQL_DATABASE:-cnpmcore}
    volumes:
      - cnpm-mysql:/var/lib/mysql
-      # - ./conf.d/mysql/:/etc/mysql/conf.d
-      # - ./init.d/mysql/:/docker-entrypoint-initdb.d
    ports:
      - 3306:3306
    networks:
-      - cnpm
+      - cnpm-mysql

  # database explorer
  phpmyadmin:
+    env_file:
+      - .env
    image: phpmyadmin
    restart: always
    environment:
-      MYSQL_ROOT_PASSWORD:
+      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD:-}
      MYSQL_ALLOW_EMPTY_PASSWORD: 'yes'
-      MYSQL_USER: user
-      MYSQL_PASSWORD: pass
+      MYSQL_DATABASE: ${MYSQL_DATABASE:-cnpmcore}
+      # MYSQL_USER: ${MYSQL_USER:-user}
+      # MYSQL_PASSWORD: ${MYSQL_PASSWORD:-pass}
      PMA_HOST: 'mysql'
    ports:
      - 8080:80
    networks:
-      - cnpm
+      - cnpm-mysql
    depends_on:
      - mysql

@@ -51,8 +55,7 @@ volumes:
  cnpm-redis:
  cnpm-mysql:

-
 networks:
-  cnpm:
-    name: cnpm
+  cnpm-mysql:
+    name: cnpm-mysql
    driver: bridge
--- a/prepare-database-mysql.sh
+++ b/prepare-database-mysql.sh
@@ -1,5 +1,7 @@
 #!/bin/bash

+# set -ex
+
 # read variables from environment
 db_host=${CNPMCORE_DATABASE_HOST:-127.0.0.1}
 db_port=${CNPMCORE_DATABASE_PORT:-3306}
--- a/prepare-database-postgresql.sh
+++ b/prepare-database-postgresql.sh
@@ -3,10 +3,10 @@
 # set -ex

 # read variables from environment
-db_host=${POSTGRES_HOST:-}
+db_host=${POSTGRES_HOST:-127.0.0.1}
 db_port=${POSTGRES_PORT:-5432}
-db_username=${POSTGRES_USER:-}
-db_password=${POSTGRES_PASSWORD:-} # default to empty password
+db_username=${POSTGRES_USER:-postgres}
+db_password=${POSTGRES_PASSWORD:-postgres} # default to empty password
 db_name=${CNPMCORE_DATABASE_NAME:-cnpmcore_unittest}

 # prepare PostgreSQL param
--- a/test/TestUtil.ts
+++ b/test/TestUtil.ts
@@ -49,7 +49,7 @@ export class TestUtil {
  static getDatabaseConfig() {
    return {
      ...database,
-      database: database.name ?? 'cnpmcore_unittest',
+      database: database.name || 'cnpmcore_unittest',
      multipleStatements: true,
    };
  }