enterpriseconnect/agent

EC OCI 规范

在Docker镜像中运行EC代理工件不推荐，因为其依赖底层Linux cgroup与Docker。cgroup存在于Docker核心中，设计上需要来自宿主系统的sudo权限。希望通过在容器内运行非sudo用户来提升安全性的Docker用户，应避免在宿主主机上进行卷共享。

因此，强烈建议将此镜像作为无root/非特权容器运行。有关更多信息，请参考https://github.com/opencontainers/runc%E5%92%8CLinux cgroup手册man cgroups。

开源项目采用流程：

cgroup >> runc + nsenter >> moby >> docker

root权限本身违背了EC无root连接模型的目的，并最终会在宿主主机上造成多个安全漏洞。但值得注意的是，运行独立代理不需要sudo/root权限。请参考独立部署的代理源码库。处于严格安全环境（如AWS GovCloud）的用户应考虑基于此仓库中的规范示例构建自定义镜像。

EC Agent OCI镜像目前在https://hub.docker.com/repository/docker/enterpriseconnect/agent%E7%BB%B4%E6%8A%A4%EF%BC%9B%E4%BD%BF%E7%94%A8%E8%A7%84%E8%8C%83%E9%80%82%E7%94%A8%E4%BA%8E%E5%A4%9A%E7%A7%8D%E8%AE%A1%E7%AE%97%E7%8E%AF%E5%A2%83%E3%80%82%E5%A6%82%E9%9C%80%E4%BA%86%E8%A7%A3EC%E4%BD%BF%E7%94%A8%E7%A4%BA%E4%BE%8B%EF%BC%8C%E8%AF%B7%E8%AE%BF%E9%97%AEhttps://github.com/Enterprise-connect/ec-x-sdk/tree/v1/examples%EF%BC%8C%E5%A6%82%E5%88%9A%E6%8E%A5%E8%A7%A6EC%EF%BC%8C%E8%AF%B7%E6%9F%A5%E7%9C%8Bhttps://github.com/Enterprise-connect/ec-sdk/wiki/EC-Agent%E3%80%82

OCI（开放容器倡议）是开放容器倡议社区的持续商标，目前由社区章程管理。

Docker 标签

构建代理相关工件

拉取示例

docker pull enterpriseconnect/build:v1beta

可用标签

• https://github.com/Enterprise-connect/oci/blob/v1/spec/build/Dockerfile%E3%80%81%60%60%60latest%60%60%60
• https://github.com/Enterprise-connect/oci/blob/v1beta/spec/build/Dockerfile
• https://github.com/Enterprise-connect/oci/blob/v1beta/spec/build/Dockerfile

标签用途

• v1 用于构建代理 #212+ 相关版本。
• v1beta 用于构建代理 #1724+ 相关版本。
• v1.1beta 用于构建代理 #2721+ 相关版本。

容器中的代理

拉取示例

docker pull enterpriseconnect/agent:v1beta

可用标签

• https://github.com/Enterprise-connect/oci/blob/v1/spec/agent/Dockerfile%E3%80%81https://github.com/Enterprise-connect/oci/blob/v1/spec/agent/Dockerfile%E3%80%81https://github.com/Enterprise-connect/oci/blob/v1/spec/agent/Dockerfile
• v1-python、v1-ci
• https://github.com/Enterprise-connect/oci/blob/v1beta/spec/agent/Dockerfile%E3%80%81https://github.com/Enterprise-connect/oci/blob/v1beta/spec/agent/Dockerfile
• v1beta-python、v1beta-ci
• https://github.com/Enterprise-connect/oci/blob/v1beta/spec/build/Dockerfile
• https://github.com/Enterprise-connect/oci/blob/v1/spec/build/Dockerfile

标签用途

• v1 对应代理 #212 版本。
• v1beta 包含代理 #1724 候选版本。
• <tag>-build 包含构建代理版本所需的一系列工具。

使用方法

Docker 运行示例

在此容器规范示例中，预定义的代理镜像通过Docker启动。示例中的代理标志被转换为多个环境变量，这些变量基于EC使用所需的<path/to/this/repo>/spec/<agent-mode>.yml文件。例如，要启动客户端模式的代理容器，需要注入环境变量EC_AID、EC_TID、EC_HST等。

--env-file中指定的环境变量需要替换为示例YAML文件中所示的一系列相关标志。

shell
docker run --env-file client.list \
  enterpriseconnect/agent:v1

有关Docker标志-e的使用，请https://github.com/Enterprise-connect/oci/blob/v1/.travis.yml#L11%E3%80%82

Kubernetes 部署示例

在K8s实例中部署代理时，必要的环境变量如示例/path/to/the/repo/k8s/agent-<object>.yml中指定。K8s用户可使用任何自定义对象（如configmap插件）辅助配置。