google/dart-runtime-base

重要提示：该镜像已停止维护

请考虑使用新的Dart Docker官方镜像：https://hub.docker.com/_/dart

google/dart-runtime-base

https://index.docker.io/u/google/dart-runtime-base 是一个[***]

如果您的Dart应用不需要本地包，可能可以使用更简单的基础镜像https://index.docker.io/u/google/dart-runtime。

使用此镜像需要遵循预定义的目录结构，并配合遵循预定义模板的Dockerfile。

该镜像基于https://index.docker.io/u/google/dart基础镜像构建。

如果以下描述的目录结构不适合您的设置，基于https://index.docker.io/u/google/dart基础镜像构建Dockerfile可能是更好的选择。

使用方法

需使用以下目录结构：

project
  Dockerfile
  app
    bin
      server.dart
    pubspec.yaml
  pkg
    my-package-1
    my-package-2

顶级目录project包含Dockerfile以及两个目录app和pkg。app目录包含Dart应用，主入口点为bin/server.dart。app/pubspec.yaml中引用的包必须是pub.dartlang.org上的包，或pkg目录中的包（通过相对path依赖引用），例如：

yaml
name: dart_app
version: 0.1.0
description: Dart application.
dependencies:
  my-package-1:
    path: ../pkg/my-package-1
  my-package-2:
    path: ../pkg/my-package-2

您也可以使用dependency_overrides（依赖覆盖），例如：

yaml
name: dart_app
version: 0.1.0
description: Dart application.
dependencies:
  some-package: any
dependency_overrides:
  my-package-1:
    path: ../pkg/my-package-1
  my-package-2:
    path: ../pkg/my-package-2

然后在Dart应用目录中创建Dockerfile，内容如下：

dockerfile
FROM docker.xuanyuan.run/google/dart-runtime-base

WORKDIR /project/app

# 添加每个本地包的pubspec.yaml文件
ADD pkg/my-package-1/pubspec.yaml /project/pkg/my-package-1/
ADD pkg/my-package-2/pubspec.yaml /project/pkg/my-package-2/

# 添加应用和本地包的模板
ADD app/pubspec.* /project/app/
RUN pub get
ADD . /project
RUN pub get --offline

根据您的本地包情况，需要修改“添加每个本地包的pubspec.yaml文件”部分后的ADD命令。为每个本地包添加一条ADD命令。注意ADD命令的末尾是否需要/。Dockerfile的其余部分可直接复制。

构建镜像

要构建标记为my/app的Docker镜像，运行：

bash
docker build -t my/app .

运行容器

运行此镜像（假设是监听8080端口的服务器应用）：

bash
docker run -d -p 8080:8080 docker.xuanyuan.run/my/app

访问观测台（Observatory）

dart-runtime-base镜像为容器中运行的Dart VM启用了观测台（Observatory）。观测台默认监听8181端口。运行应用时将该端口映射到主机即可：

bash
docker run -d -p 8080:8080 -p 8181:8181 docker.xuanyuan.run/my-app

如果使用boot2docker，可通过Docker主机网络访问观测台，地址为[***]

传递VM标志

dart-runtime-base镜像可通过环境变量DART_VM_OPTIONS接收Dart VM的选项：

bash
docker run -d -p 8080:8080 \
    --env DART_VM_OPTIONS='--old_gen_heap_size=2048 --verbose-gc' \
    docker.xuanyuan.run/my/app

在App Engine Managed VMs中使用

如果在App Engine Managed VMs中使用此镜像，app.yaml文件必须与Dockerfile一起放在项目目录中。

配置观测台访问

在app.yaml中添加以下内容以启用观测台访问：

yaml
network:
  forwarded_ports: ["8181"]

传递VM标志

在app.yaml中添加以下内容以传递VM标志：

yaml
env_variables:
  DART_VM_OPTIONS: --old_gen_heap_size=2048 --verbose-gc