如何把一个Python应用程序装进Docker

 准备

容器无处不在,但是如何在Docker容器中运行Python应用程序呢?这篇文章将告诉你怎么做!

如何把一个Python应用程序装进Docker

如果您想知道,这些示例需要Python 3.x。

在深入讨论容器之前,让我们进一步讨论一下我们想要封装的Python应用程序。

这个应用程序是一个web API,它从一个电影集合中返回一个随机的电影。在我们的本地文件夹中,我们有3个文件:

app.py # Python application 
movies.json # movie collection 
requirements.txt # where we specifiy our Python dependencies 

app.py包含一个API端点,它返回一个随机的影片:

import os 
import json 
from pathlib import Path 
from random import choice 
import cherrypy 
 
PORT = os.environ.get('PORT', 8888) 
 
FOLDER_PATH = Path(__file__).parent 
 
with open(FOLDER_PATH / "movies.json", "r") as f: 
    MOVIES = json.loads(f.read()) 
 
class Movie: 
    @cherrypy.expose 
    @cherrypy.tools.json_out() 
    def index(self): 
        return {"movie": choice(MOVIES)} 
 
cherrypy.quickstart( 
    Movie(), config=cherrypy.config.update({ 
        'server.socket_host': '0.0.0.0', 
        'server.socket_port': PORT, 
        })) 

requirement.txt,我们有我们的依赖包

pip install -r requirements.txt 

我们可以使用python app.py运行我们的应用程序。

运行curl localhost:8888应该返回一个随机的影片,类似于:

{ 
  "movie": { 
    "Title": "Opal Dreams", 
    "US_Gross": 14443, 
    "Worldwide_Gross": 14443, 
    "US_DVD_Sales": null, 
    "Production_Budget": 9000000, 
    "Release_Date": "Nov 22 2006", 
    "MPAA_Rating": "PG", 
    "Running_Time_min": null, 
    "Distributor": "Strand", 
    "Source": "Based on Book/Short Story", 
    "Major_Genre": "Drama", 
    "Creative_Type": "Contemporary Fiction", 
    "Director": null, 
    "Rotten_Tomatoes_Rating": null, 
    "IMDB_Rating": 6.5, 
    "IMDB_Votes": 468 
  } 
} 

如何容器化我们的程序

包含一个Python应用程序意味着创建一个Docker镜像,其中包含运行它所需要的一切:源代码、依赖项和配置。

容器化应用程序的第一步是创建一个新的文本文件,名为Dockerfile:

app.py 
movies.json 
requirements.txt 
Dockerfile 

在Dockerfile(我们认为是最小可行Dockerfile)中,我们需要指定三个步骤:

  • 选择我们想要使用的基本图像
  • 选择我们想要在Docker图像中复制的文件
  • 安装应用程序的依赖项

Base image

要指定基本映像,我们使用FROM命令,后面跟着私有或公共映像。

在我们的例子中,我们将使用官方的Python Docker映像,该映像可在Docker hub上使用。

我们将选择最新可用的基于Ubuntu的python3图像。

# 1. Base image 
FROM python:3.8.5-slim-buster 

图像名称由两个不同的部分组成:image:tag。在我们的例子中,图像是python,标签是3.8.5-slim-buster。

这就是第一步所需要的一切。

复制应用程序

要在Docker图像中复制我们的应用程序,我们将使用copy命令:

# 2. Copy files 
COPY . /src 

此命令将指定的文件(或文件夹)复制到Docker映像中。在我们的例子中,我们希望复制Docker映像中本地文件夹中/src路径下的所有可用文件。

值得注意的是,COPY命令的第一部分是相对于构建上下文的路径,而不是相对于我们的本地机器的路径。

安装requirements.txt

最后一步是在Docker映像中安装我们的依赖项。为了实现这一点,我们将使用RUN命令运行pip安装:

# 3. Install our deps 
RUN pip install -r /src/requirements.txt 

需要注意的一件事是,requirements.txt的路径与我们第一次运行pip安装时不同。

这背后的原因是复制的文件在映像内的/src路径下。

构建并运行Docker映像

# 1. Base image 
FROM python:3.8.3-slim-buster 
 
# 2. Copy files 
COPY . /src 
 
# 3. Install our deps 
RUN pip install -r /src/requirements.txt 

我们的Dockerfile现在已经完成,我们可以使用它来构建Docker映像。为此,我们需要使用docker构建命令:

docker build -t movie-recommender . 

这个命令使用当前文件夹作为构建上下文构建一个名为movie-recommender的Docker图像。在最后指定我们想要使用的构建上下文的路径)。

现在我们可以使用docker run命令运行刚刚构建的图像:

docker run movie-recommender python /src/app.py 

该命令将在基于电影推荐图像的容器中执行python /src/app.py。

但是,如果我们尝试使用curl localhost:8888连接到我们的应用程序,我们将会得到一个错误。

这怎么可能?为什么我们不能连接到在容器内运行的应用程序?

原因是我们没有将应用程序的端口公开给本地机器。我们可以使用-p HostPort:ContainerPort标志来实现这一点。

因此,让我们尝试再次运行该命令,这一次指定我们希望在本地公开端口8888:

docker run -p 8888:8888 movie-recommender python /src/app.py 

相关推荐