Python 3.4 容器镜像

此容器镜像包含Python 3.4，作为构建Python 3.4应用程序的S2I基础镜像。用户可选择基于RHEL或CentOS的构建器镜像。RHEL镜像可在Red Hat Container Catalog获取，镜像名为registry.access.redhat.com/rhscl/python-34-rhel7；CentOS镜像可在Docker Hub获取，镜像名为centos/python-34-centos7。生成的镜像可使用Docker运行。

概述

Python 3.4容器镜像是构建和运行各种Python 3.4应用程序及框架的基础平台。Python是一种易于学***、功能强大的编程语言，具有高效的高级数据结构和简单而有效的面向对象编程方法。其优雅的语法、动态类型以及解释型特性，使其成为在多数平台的许多领域中进行脚本编写和快速应用开发的理想语言。

核心功能与特性

• 提供Python 3.4运行环境，支持构建和运行各类Python应用
• 支持基于RHEL和CentOS两种操作系统的基础镜像
• 集成S2I（Source-to-Image）工具，简化应用构建流程
• 灵活的运行策略，支持Gunicorn、Django开发服务器、Python脚本及自定义脚本等多种启动方式
• 丰富的环境变量配置，可定制应用部署参数

使用场景

适用于需要使用Python 3.4版本开发、构建和运行应用程序的场景，包括但不限于：

• Python Web应用开发与部署
• 数据处理脚本运行
• 小型Python服务构建
• 基于Django等框架的应用部署

使用方法

构建并运行应用示例

使用独立的S2I构建简单的python-sample-app应用，然后用Docker运行生成的镜像，请执行：

基于RHEL的镜像

$ s2i build [***] --context-dir=3.4/test/setup-test-app/ rhscl/python-34-rhel7 python-sample-app
$ docker run -p 8080:8080 python-sample-app

基于CentOS的镜像

$ s2i build [***] --context-dir=3.4/test/setup-test-app/ centos/python-34-centos7 python-sample-app
$ docker run -p 8080:8080 python-sample-app

访问应用

$ curl 127.0.0.1:8080

环境变量配置

可在源代码仓库的.s2i/environment文件中以键值对形式设置以下环境变量：

APP_SCRIPT

用于从脚本文件运行应用。应指定脚本文件路径（默认值为app.sh，若设为null则不使用默认值），该脚本将被执行以启动应用。

APP_FILE

用于从Python脚本运行应用。应指定Python文件路径（默认值为app.py，若设为null则不使用默认值），该文件将被传递给Python解释器以启动应用。

APP_MODULE

用于通过Gunicorn运行应用，如此处所述。此变量指定WSGI可调用对象，格式为MODULE_NAME:VARIABLE_NAME，其中MODULE_NAME是模块的完整点分路径，VARIABLE_NAME是指定模块中的WSGI可调用对象。若未指定，Gunicorn将查找名为application的WSGI可调用对象。

若未提供APP_MODULE，run脚本将在项目中查找wsgi.py文件并使用（如果存在）。

若使用setup.py安装应用，MODULE_NAME部分可从中读取。示例可参见setup-test-app。

APP_HOME

此变量可用于指定包含待运行应用的子目录。该目录需包含wsgi.py（用于Gunicorn）或manage.py（用于Django）。

若未提供APP_HOME，assemble和run脚本将使用应用的根目录。

APP_CONFIG

指向有效的Python文件路径，该文件包含Gunicorn配置。

DISABLE_MIGRATE

设为非空值可阻止运行生成的镜像时执行manage.py migrate。仅影响Django项目。有关在OpenShift环境中如何/何时运行数据库迁移的建议，参见OpenShift博客上的Django文章的“处理数据库迁移”部分。重要的是，注意从两个或多个Pod运行数据库迁移可能会损坏数据库。

DISABLE_COLLECTSTATIC

设为非空值可阻止构建期间执行manage.py collectstatic。仅影响Django项目。

DISABLE_SETUP_PY_PROCESSING

设为非空值可跳过setup.py脚本的处理（如果在requirements.txt中使用-e .触发其处理，或不希望应用安装到site-packages目录）。

ENABLE_PIPENV

设为非空值可使用Pipenv（高级Python打包工具）管理应用依赖。仅当项目包含格式正确的Pipfile和Pipfile.lock时使用。（隐含UPGRADE_PIP_TO_LATEST以满足Pipenv的依赖。）

PIP_INDEX_URL

设置此变量可使用自定义索引URL或镜像在构建过程中下载所需包。仅影响requirements.txt中列出的包。Pipenv忽略此变量。

UPGRADE_PIP_TO_LATEST

设为非空值可在安装任何Python包前将pip程序及相关Python包（setuptools和wheel）升级到最新版本。若未设置，将使用平台为所用Python版本包含的默认版本。

WEB_CONCURRENCY

设置此变量可更改工作进程数的默认设置。默认情况下，设置为可用核心数乘以2，上限为12。

源代码仓库布局

现有Python项目的仓库无需任何更改。但以下文件若存在，将影响构建过程：

requirements.txt

需用pip安装的依赖列表。格式参见此处。

Pipfile

requirements.txt的替代方案，目前处于积极设计和开发中，文档参见此处。需设置ENABLE_PIPENV环境变量为true以处理此文件。

setup.py

配置项目的各个方面，包括依赖安装，文档参见此处。多数项目只需使用requirements.txt或Pipfile即可。设置DISABLE_SETUP_PY_PROCESSING环境变量为true可跳过此文件的处理。

运行策略

s2i-python生成的容器镜像按以下优先级顺序运行项目：

Gunicorn

若安装了Gunicorn（通过requirements.txt或setup.py的install_requires部分列出），则使用Gunicorn WSGI HTTP服务器提供应用服务。

若仓库中存在wsgi.py文件，将用作应用的入口点。可通过APP_MODULE环境变量覆盖。Django项目默认包含此文件。

若requirements中同时包含Django和Gunicorn，Django项目将自动使用Gunicorn提供服务。

Django开发服务器

若requirements中包含Django但未包含Gunicorn，则使用Django的开发Web服务器提供应用服务。不建议用于生产环境。

Python脚本

当通过APP_FILE环境变量指定Python脚本路径（默认若存在app.py文件）时使用。脚本将传递给Python解释器以启动应用。

应用脚本文件

最通用的应用启动方式。当通过APP_SCRIPT环境变量指定可执行脚本路径（默认若存在app.sh文件）时使用。脚本将直接执行以启动应用。

热部署

若使用Django，热部署默认生效。

若使用Gunicorn并需启用热部署，确保仓库中包含Gunicorn配置文件，且reload选项设为true。确保通过APP_CONFIG环境变量指定配置文件。

要修改运行中容器的源代码，使用Docker的exec命令：

docker exec -it <容器ID> /bin/bash

进入运行中的容器后，当前目录设为/opt/app-root/src，即源代码所在位置。

另请参见

Dockerfile及其他源代码可在[***]