Docker Hub 快速入门

Docker Hub 提供了一个庞大的预构建镜像和资源库,加速了开发工作流程并减少了设置时间。您可以在 Docker Hub 的预构建镜像基础上进行构建,然后使用仓库与您的团队或数百万其他开发者共享和分发您自己的镜像。

本指南向您展示如何查找并运行预构建的镜像。然后,它将引导您创建一个自定义镜像,并通过Docker Hub共享它。

先决条件

步骤 1: 在 Docker Hub 的库中找到一个镜像

您可以在Docker Hub本身、Docker Desktop仪表板或使用CLI搜索内容。

要在Docker Hub上搜索或浏览内容:


  1. 导航到 Docker Hub 探索页面.

    探索页面,您可以通过目录或类别浏览,或使用搜索快速找到内容。

  2. 类别下,选择Web服务器

    结果显示后,您可以使用页面左侧的过滤器进一步筛选结果。

  3. 在过滤器中,选择Docker官方镜像

    通过可信内容过滤,确保您仅看到由Docker及其验证的发布合作伙伴策划的高质量、安全图像。

  4. 在结果中,选择nginx镜像。

    选择图像将打开图像的页面,您可以在该页面上了解更多关于如何使用该图像的信息。在页面上,您还会找到docker pull命令来拉取图像。

  1. 打开Docker桌面仪表板。

  2. 选择Docker Hub视图。

    Docker Hub视图中,您可以通过目录或类别浏览,或使用搜索快速找到内容。

  3. 将搜索框留空,然后选择搜索

    搜索结果现在显示在搜索框旁边的附加过滤器中。

  4. 选择搜索过滤器图标,然后选择Docker官方镜像Web服务器

  5. 在结果中,选择nginx镜像。

  1. 打开一个终端窗口。

    提示

    Docker Desktop 仪表板包含一个内置终端。在仪表板的底部,选择 >_ 终端 以打开它。

  2. 在终端中,运行以下命令。

    $ docker search --filter is-official=true nginx
    

    与Docker Hub和Docker Desktop界面不同,您无法使用docker search命令按类别浏览。有关该命令的更多详细信息,请参阅 docker search


既然你已经找到了一个镜像,是时候在你的设备上拉取并运行它了。

步骤 2: 从 Docker Hub 拉取并运行一个镜像

您可以使用CLI或Docker Desktop仪表板从Docker Hub运行镜像。


  1. 在Docker Desktop仪表板中,选择Docker Hub视图中的nginx镜像。更多详情,请参阅 步骤1:在Docker Hub的库中查找镜像

  2. nginx屏幕上,选择运行

    如果您的设备上不存在该镜像,它将自动从Docker Hub拉取。拉取镜像可能需要几秒钟或几分钟,具体取决于您的网络连接。镜像拉取完成后,Docker Desktop中会出现一个窗口,您可以指定运行选项。

  3. 主机端口选项中,指定8080

  4. 选择运行

    容器日志在容器启动后出现。

  5. 选择8080:80链接以打开服务器,或访问 https://localhost:8080在您的网络浏览器中。

  6. 在Docker桌面仪表板中,选择停止按钮以停止容器。

  1. 打开一个终端窗口。

    提示

    Docker Desktop 仪表板包含一个内置终端。在仪表板的底部,选择 >_ 终端 以打开它。

  2. 在您的终端中,运行以下命令以拉取并运行Nginx镜像。

    $ docker run -p 8080:80 --rm nginx
    

    docker run 命令会自动拉取并运行镜像,无需先运行 docker pull。要了解更多关于该命令及其选项的信息,请参阅 docker run CLI 参考。运行命令后,您应该会看到类似以下的输出。

    Unable to find image 'nginx:latest' locally
    latest: Pulling from library/nginx
    a480a496ba95: Pull complete
    f3ace1b8ce45: Pull complete
    11d6fdd0e8a7: Pull complete
    f1091da6fd5c: Pull complete
    40eea07b53d8: Pull complete
    6476794e50f4: Pull complete
    70850b3ec6b2: Pull complete
    Digest: sha256:28402db69fec7c17e179ea87882667f1e054391138f77ffaf0c3eb388efc3ffb
    Status: Downloaded newer image for nginx:latest
    /docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
    /docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
    /docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
    10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
    10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
    /docker-entrypoint.sh: Sourcing /docker-entrypoint.d/15-local-resolvers.envsh
    /docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
    /docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
    /docker-entrypoint.sh: Configuration complete; ready for start up
    2024/11/07 21:43:41 [notice] 1#1: using the "epoll" event method
    2024/11/07 21:43:41 [notice] 1#1: nginx/1.27.2
    2024/11/07 21:43:41 [notice] 1#1: built by gcc 12.2.0 (Debian 12.2.0-14)
    2024/11/07 21:43:41 [notice] 1#1: OS: Linux 6.10.11-linuxkit
    2024/11/07 21:43:41 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
    2024/11/07 21:43:41 [notice] 1#1: start worker processes
    2024/11/07 21:43:41 [notice] 1#1: start worker process 29
    ...
    
  3. 访问 https://localhost:8080 查看默认的 Nginx页面并验证容器是否正在运行。

  4. 在终端中,按下 Ctrl+C 停止容器。


你现在已经运行了一个无需任何设置或配置的Web服务器。Docker Hub 提供了对预构建、即用型容器镜像的即时访问,让你能够快速拉取并运行应用程序,而无需手动安装或配置软件。借助 Docker Hub 庞大的镜像库,你可以轻松地试验和部署应用程序,提高生产力,并使得尝试新工具、设置开发环境或在现有软件基础上构建变得轻而易举。

您还可以从Docker Hub扩展镜像,让您快速构建和自定义自己的镜像以满足特定需求。

步骤3:构建并将镜像推送到Docker Hub

  1. 创建一个 Dockerfile 来指定您的应用程序:

    FROM nginx
    RUN echo "<h1>Hello world from Docker!</h1>" > /usr/share/nginx/html/index.html

    这个Dockerfile扩展了Docker Hub上的Nginx镜像,用于创建一个简单的网站。只需几行代码,您就可以轻松设置、定制并使用Docker分享一个静态网站。

  2. 运行以下命令来构建你的镜像。将替换为你的Docker ID。

    $ docker build -t <YOUR-USERNAME>/nginx-custom .
    

    此命令构建您的镜像并为其打标签,以便Docker知道将其推送到Docker Hub中的哪个仓库。要了解更多关于该命令及其选项的信息,请参阅docker build CLI 参考。运行命令后,您应该会看到类似于以下的输出。

    [+] Building 0.6s (6/6) FINISHED                      docker:desktop-linux
     => [internal] load build definition from Dockerfile                  0.0s
     => => transferring dockerfile: 128B                                  0.0s
     => [internal] load metadata for docker.io/library/nginx:latest       0.0s
     => [internal] load .dockerignore                                     0.0s
     => => transferring context: 2B                                       0.0s
     => [1/2] FROM docker.io/library/nginx:latest                         0.1s
     => [2/2] RUN echo "<h1>Hello world from Docker!</h1>" > /usr/share/  0.2s
     => exporting to image                                                0.1s
     => => exporting layers                                               0.0s
     => => writing image sha256:f85ab68f4987847713e87a95c39009a5c9f4ad78  0.0s
     => => naming to docker.io/mobyismyname/nginx-custom                  0.0s
    
  3. 运行以下命令来测试你的镜像。将 替换为你的 Docker ID。

    $ docker run -p 8080:80 --rm <YOUR-USERNAME>/nginx-custom
    
  4. 访问 https://localhost:8080 查看页面。你应该会看到 Hello world from Docker!

  5. 在终端中,按CTRL+C停止容器。

  6. 登录到Docker Desktop。在将镜像推送到Docker Hub之前,您必须登录。

  7. 运行以下命令将您的镜像推送到Docker Hub。将替换为您的Docker ID。

    $ docker push <YOUR-USERNAME>/nginx-custom
    

    注意

    您必须通过Docker Desktop或命令行登录到Docker Hub,并且还必须按照上述步骤正确命名您的镜像。

    该命令将镜像推送到 Docker Hub,如果仓库不存在,则会自动创建。要了解更多关于该命令的信息,请参阅 docker push CLI 参考。运行命令后,您应该会看到类似以下的输出。

    Using default tag: latest
    The push refers to repository [docker.io/mobyismyname/nginx-custom]
    d0e011850342: Pushed
    e4e9e9ad93c2: Mounted from library/nginx
    6ac729401225: Mounted from library/nginx
    8ce189049cb5: Mounted from library/nginx
    296af1bd2844: Mounted from library/nginx
    63d7ce983cd5: Mounted from library/nginx
    b33db0c3c3a8: Mounted from library/nginx
    98b5f35ea9d3: Mounted from library/nginx
    latest: digest: sha256:7f5223ae866e725a7f86b856c30edd3b86f60d76694df81d90b08918d8de1e3f size: 1985
    

现在你已经创建了一个仓库并推送了你的镜像,是时候查看你的仓库并探索其选项了。

步骤4:在Docker Hub上查看您的仓库并探索选项

您可以在Docker Hub或Docker Desktop界面中查看您的Docker Hub仓库。


  1. 前往 Docker Hub 并登录。

    登录后,您应该会进入Repositories页面。如果没有,请前往 仓库页面。

  2. 找到nginx-custom仓库并选择该行。

    选择仓库后,您应该会看到更多关于仓库的详细信息和选项。

  1. 登录到Docker Desktop。

  2. 选择图像视图。

  3. 选择Hub 仓库标签。

    您的Docker Hub仓库列表显示出来。

  4. 找到nginx-custom仓库,将鼠标悬停在该行上,然后选择在Hub中查看

    Docker Hub 打开,您可以查看有关镜像的更多详细信息。


您现在已经验证了您的仓库存在于Docker Hub上,并且您已经发现了更多关于它的选项。查看下一步以了解更多关于这些选项的信息。

下一步

添加 仓库信息 以帮助用户找到并使用 您的镜像。