本页面介绍了如何创建自定义 Docker 映像并将其用作 用于教程和学习活动的 Cloud Shell 环境。
如需创建自定义 Cloud Shell 体验,您需要创建 Docker 映像,该映像充当具有指定其他软件包和自定义配置的自定义 Cloud Shell 环境。您的 Docker 映像必须基于 Cloud Shell 基础映像,并托管在 Container Registry 中。
创建自定义 Docker 映像
如需遵循有关此任务的分步指导,请直接在 Cloud Shell Editor 中点击操作演示:
按照以下说明创建您自己的自定义 Docker 映像:
在 Cloud Shell 终端标签页中,运行以下命令,以在 Cloud Source Repositories 托管的代码库中创建样板自定义映像:
cloudshell env create-custom-image NEW_REPO_NAME
gcloud source repos list
或者,如果您希望手动部署到 Container Registry 或使用自己的自动化流程,则可以创建新的空 Dockerfile 并跳到第 3 步。
按照输出到命令行的说明打开新的 Dockerfile:
cd $HOME/NEW_REPO_NAME && cloudshell edit Dockerfile
在 Cloud Shell 体验的第一行中添加您想要使用的任何其他软件包。例如:
FROM gcr.io/cloudshell-images/cloudshell:latest RUN apt-get -y install lsof
Dockerfile 中的第一行
FROM gcr.io/cloudshell-images/cloudshell:latest
,引用基准 Cloud Shell 映像,不应移除。通过运行以下命令在本地构建映像:
cloudshell env build-local
通过运行以下命令在本地测试映像,并验证已安装的软件包是否存在:
cloudshell env run
如需退出测试,请运行以下命令:
exit
在本地提交代码更改:
git commit -a -m "Initial custom environment check-in."
将代码更改推送到 Cloud Source Repositories:
git push origin master
最后,将您的自定义映像推送到 Container Registry:
cloudshell env push
更新“在 Cloud Shell 中打开”链接
要通过在 Cloud Shell 中打开链接使用自定义映像,您需要先将其公开。如需了解将自定义映像设为公开的步骤,请按照 Container Registry 访问权限控制指南进行操作。
只要设置了恰当的访问权限设置,您便可
在 Cloud Shell 中打开链接以指定 cloudshell_git_repo
和 cloudshell_image
参数。例如,如需添加在 Google Cloud 中打开
Shell 按钮,修改以下示例中的网址,然后添加一个类似
添加到 Markdown 文件中:
[![Open in Cloud Shell](https://gstatic.com/cloudssh/images/open-btn.svg)](https://shell.cloud.google.com/cloudshell/editor?cloudshell_git_repo=REPO_URL&cloudshell_image=DOCKER_IMAGE_URL)
替换以下值:
- REPO_URL:代码库位置的网址
- DOCKER_IMAGE_URL:Docker 映像的网址
如需详细了解这些参数和其他参数,请参阅 在 Cloud Shell 中打开。
让自定义容器映像保持最新状态
您的自定义容器必须基于最新公开的时间 Cloud Shell 映像 如何使用 Cloud Shell我们建议您每周重新构建一次,以确保自定义映像保持最新状态。