woahbase/alpine-ionic

Alpine-Ionic镜像概述

该镜像容器化了Ionic CLI和Cordova工具及其NPM依赖，基于Alpine Linux系统和woahbase/alpine-nodejs镜像，叠加s6 init系统，支持x86_64架构（标记为latest）。镜像仅用于Ionic/Angular应用的开发阶段，不包含Android构建所需的JDK、Android Tools或Gradle等环境。

核心功能

1. 提供Ionic CLI和Cordova工具，支持初始化、脚手架搭建Ionic/Angular项目
2. 支持非root用户运行：通过PUID/PGID参数指定用户权限，默认使用alpine用户
3. 可挂载本地项目目录，实现开发文件同步
4. 支持调整entrypoint执行npm脚本等扩展操作

使用场景

1. Ionic/Angular应用的初始化与项目结构搭建
2. 本地开发服务器运行（如ionic serve）
3. 执行项目中的npm脚本（如启动Angular开发服务）
4. 开发阶段的命令行工具调用（如ionic generate）

配置说明

1. 挂载项目目录：将本地项目根目录（含package.json）挂载到容器内/home/alpine/project
2. 权限配置：通过-e PGID=xxx -e PUID=xxx指定用户ID（可通过id命令获取本地用户ID）
3. 端口映射：默认暴露8100端口（Ionic开发服务器端口）
4. 时间同步：挂载本地/etc/localtime确保时间一致

部署示例

拉取镜像

bash
docker pull woahbase/alpine-ionic:x86_64

初始化项目

bash
docker run --rm -it \
  --name docker_ionic \
  -e PGID=1000 -e PUID=1000 \
  -p 8100:8100 \
  -v $PWD/project:/home/alpine/project \
  woahbase/alpine-ionic:x86_64 \
  start

运行开发服务器

bash
docker run --rm -it \
  --name docker_ionic \
  -e PGID=1000 -e PUID=1000 \
  -p 8100:8100 \
  -v $PWD/project:/home/alpine/project \
  -v /etc/localtime:/etc/localtime:ro \
  woahbase/alpine-ionic:x86_64 \
  serve

执行npm脚本

bash
docker run --rm -it \
  --name docker_ionic \
  --entrypoint npm \
  -e PGID=1000 -e PUID=1000 \
  -p 8100:8100 \
  -v $PWD/project:/home/alpine/project \
  woahbase/alpine-ionic:x86_64 \
  start

进入容器Shell

bash
# 普通用户
docker exec -it docker_ionic /bin/bash
#  root用户
docker exec -u root -it docker_ionic /bin/bash

本地构建镜像（需Git、Docker和make工具）

bash
git clone https://github.com/woahbase/alpine-ionic
cd alpine-ionic
make ARCH=x86_64 build

维护信息

• 源码仓库：https://github.com/woahbase/alpine-ionic
• 镜像地址：https://hub.docker.com/r/woahbase/alpine-ionic
• 维护方：WOAHBase