OpenShift

oc import-image 和 oc tag作用

Posted Cola🌀

1.oc import-image 作用

oc import-image 是 OpenShift 命令行工具 oc 的一部分，它的作用是将一个 Docker 镜像导入到 OpenShift 集群中，并将其保存到 OpenShift 镜像仓库中，以便可以在 OpenShift 中使用该镜像。

具体来说，oc import-image 命令可以从指定的 Docker 镜像源中拉取一个 Docker 镜像，并将该镜像导入到 OpenShift 集群中的镜像仓库中。这个命令还可以使用其他选项，例如 --from 选项来指定要导入的 Docker 镜像源地址，以及 --confirm 选项来确认是否导入该镜像。

在 OpenShift 中，使用 oc import-image 命令来导入 Docker 镜像非常方便，特别是当你需要将一个外部的 Docker 镜像导入到 OpenShift 集群中，以便在 OpenShift 中使用该镜像时，可以帮助你快速完成导入操作。

以下是一个使用 oc import-image 命令的例子：

oc import-image my-image --from=docker.io/myrepo/myimage:latest --confirm

这个命令会将 Docker 镜像 docker.io/myrepo/myimage:latest 导入到 OpenShift 镜像仓库中，并将其命名为 my-image。使用该命令之前，需要先登录到 OpenShift 集群中的 Docker 镜像仓库。

2.oc tag作用

oc tag 是 OpenShift 命令行工具 oc 的一部分，它的作用是将一个镜像标记为另一个标签，以便可以在 OpenShift 中使用该标记。

具体来说，oc tag 命令可以将一个镜像标记为另一个标签，并将该标签关联到镜像的 digest。这个命令还可以使用其他选项，例如 --source=docker 选项来指定要标记的 Docker 镜像，以及 --reference=tagname 选项来指定新标记的名称。

在 OpenShift 中，使用 oc tag 命令来为镜像打标记非常方便，特别是当你需要在 OpenShift 中使用一个已有的 Docker 镜像时，可以帮助你快速创建标记。

以下是一个使用 oc tag 命令的例子：

oc tag docker.io/myrepo/myimage:latest myimage:1.0

这个命令会将 Docker 镜像 docker.io/myrepo/myimage:latest 标记为 myimage:1.0，并将该标记关联到镜像的 digest。在 OpenShift 中，可以使用 myimage:1.0 标记来引用该镜像。

oc tag 命令用于将一个现有的镜像标记为另一个名称或标签，或将一个已有的 ImageStreamTag 关联到一个新的 ImageStreamImage 上。

下面是一些使用 oc tag 命令的示例：

  1. 将镜像 docker.io/nginx:latest 标记为 my-nginx:latest 并将其推送到 OpenShift 内置的镜像仓库：
$ docker pull docker.io/nginx:latest
$ docker tag docker.io/nginx:latest <registry>/myproject/my-nginx:latest
$ docker push <registry>/myproject/my-nginx:latest

2.将一个已有的 ImageStreamTag 关联到一个新的 ImageStreamImage 上：

$ oc tag myproject/my-nginx:latest myproject/my-nginx:new --reference-policy=local

这将创建一个新的 ImageStreamImage 并将其关联到 myproject/my-nginx:new 标签上。需要注意的是，这种方法并不会下载镜像，而是会直接在 OpenShift 内置的镜像仓库中创建一个新的 ImageStreamImage。

在这两个示例中，<registry> 和 <project> 分别表示 OpenShift 内置的镜像仓库的 URL 和您要将镜像推送到的项目名称。要使用 oc tag 命令，您需要使用 OpenShift CLI，并且必须具有足够的权限才能操作相应的 ImageStream 和镜像仓库。

3.dockerImageReference 是什么

dockerImageReference 是 Docker 镜像的唯一标识符，格式为 <registry>/<repository>:<tag>。

  • <registry>：Docker 镜像的注册表，通常是一个域名或者 IP 地址。
  • <repository>：Docker 镜像的仓库，用于存储镜像文件。
  • <tag>：Docker 镜像的标签，通常用于标识不同版本的镜像。

例如，Docker 官方的 nginx 镜像的 dockerImageReference 为 nginx:latest，其中 nginx 是仓库名，latest 是标签名。

在 Kubernetes 中，dockerImageReference 常用于指定 Pod 的容器镜像。可以在 Pod 模板的 spec.containers.image 字段中指定 Docker 镜像的 dockerImageReference，例如：

apiVersion: v1
kind: Pod
metadata:
  name: mypod
spec:
  containers:
  - name: mycontainer
    image: nginx:latest

以上配置将创建一个名为 mypod 的 Pod，并在其中运行一个名为 mycontainer 的容器，该容器使用 Docker 官方的 nginx 镜像的 latest 版本作为镜像。

dockerImageReference 也可以使用 SHA 值来指定 Docker 镜像。SHA 值是 Docker 镜像的唯一标识符之一，由 Docker 引擎根据镜像内容生成，可以通过 docker inspect 命令获取，格式为一个 64 位的十六进制字符串。

在 Docker 中，每个镜像都有一个唯一的 SHA 值，也称为镜像 ID。这个 SHA 值由 Docker 引擎根据镜像内容生成，可以通过 docker inspect 命令获取，格式为一个 64 位的十六进制字符串。

在 Kubernetes 中，可以通过将 dockerImageReference 的值设置为 SHA 值来指定一个确切的 Docker 镜像，例如：

apiVersion: v1
kind: Pod
metadata:
  name: mypod
spec:
  containers:
  - name: mycontainer
    image: myregistry/myrepo@sha256:abc123def456

上述示例将创建一个名为 mypod 的 Pod，并在其中运行一个名为 mycontainer 的容器，该容器使用 myregistry 中的 myrepo 仓库中的一个具有 SHA 值为 abc123def456 的镜像。由于 SHA 值是不变的，因此此镜像将永久保存，并且永远不会被更新或覆盖。

4.oc import-image 会生成imagestream吗

是的，当使用 oc import-image 命令将镜像导入到 OpenShift 集群中时，如果在命令中指定了 ImageStream 的名称，那么 OpenShift 会在导入镜像的同时自动创建该 ImageStream。例如，可以使用以下命令将 Docker Hub 上的 nginx 镜像导入到名为 my-nginx 的 ImageStream 中：

$ oc import-image my-nginx --from=nginx --confirm

执行此命令后，OpenShift 会创建名为 my-nginx 的 ImageStream，并将 Docker Hub 上的 nginx 镜像导入到该 ImageStream 中。如果指定的 ImageStream 已经存在，则会将导入的镜像追加到该 ImageStream 中。

5.openshift build 如何更新 imagestream

在 OpenShift 中，可以通过构建镜像并将其标记为 ImageStreamTag 来更新 ImageStream。以下是使用 oc new-build 命令和 oc tag 命令更新 ImageStream 的示例：

1.创建一个新的构建并将其标记为 ImageStreamTag：

$ oc new-build --name=my-image https://github.com/my/repo.git
$ oc tag my-image:latest my-imagestream:latest

这将使用 GitHub 存储库中的代码创建一个新的构建，构建输出镜像，并将其标记为 my-imagestream:latest。

2.更新 ImageStream 中的镜像版本：

$ oc start-build my-image --follow
$ oc tag my-image:latest my-imagestream:latest

这将启动一个名为 my-image 的构建，并将其输出镜像标记为 my-imagestream:latest。然后，它将使用 oc tag 命令将新的镜像版本标记为 my-imagestream:latest，从而更新 ImageStream。

在这些示例中，my-image 是构建配置的名称，my-imagestream 是 ImageStream 的名称。您可以根据需要将这些名称更改为您自己的名称。

6.oc tag 和 oc import-image 都可以生成ImageStream吗？ 有什么不同？

是的，oc tag 和 oc import-image 命令都可以生成 ImageStream。

oc tag 命令是用于将一个已存在的 ImageStreamTag 标记（即 ImageStream 的一个特定版本）关联到一个 Docker 镜像。该命令会自动创建 ImageStream（如果它不存在），并将新的 ImageStreamTag 添加到该 ImageStream 中。

oc import-image 命令是用于将一个 Docker 镜像导入到 OpenShift 集群中。该命令可以导入镜像到一个已存在的 ImageStream（如果该 ImageStream 存在），或者自动创建一个新的 ImageStream（如果该 ImageStream 不存在）。在导入镜像时，该命令会自动为镜像生成一个新的 ImageStreamTag。

因此，这两个命令的主要区别在于它们的用途和执行方式。oc tag 命令是用于关联已存在的 ImageStreamTag 和 Docker 镜像，而 oc import-image 命令则是用于将一个 Docker 镜像导入到 OpenShift 中，并自动为其生成新的 ImageStreamTag。

7.oc tag 不存在的ImageStreamTag 标记

如果执行 oc tag 命令时指定的 ImageStreamTag 不存在，则该命令会失败并显示错误消息。具体错误消息可能因 OpenShift 版本和具体情况而异，以下是一些可能的错误消息示例：

  • Error from server (NotFound): imagestreamtags.imagename:v1 not found
  • error: imagestreamtag "imagename:v1" not found

这些错误消息表明指定的 ImageStreamTag 不存在。在使用 oc tag 命令之前，需要确保要关联的 ImageStreamTag 已经存在。如果 ImageStreamTag 不存在，则需要先创建它，可以使用 oc import-image 或 oc start-build 命令来生成 ImageStreamTag。

8.一个oc tag 的例子

下面是使用 oc tag 命令将一个已存在的 ImageStreamTag 关联到一个新的 Docker 镜像的示例：

假设有一个名为 myapp 的 ImageStream，它包含有一个名为 v1 的 ImageStreamTag，表示应用程序的第一个版本。现在，我们想要将新的 Docker 镜像关联到 myapp:v1。

首先，我们需要使用 oc import-image 命令将 Docker 镜像导入到 OpenShift 中，并生成一个新的 ImageStreamTag。假设新的 Docker 镜像名称为 myregistry.com/myapp:v2，我们可以使用以下命令导入它并生成新的 myapp:v2 ImageStreamTag：

oc import-image myapp:v2 --from=myregistry.com/myapp:v2 --confirm

此命令会将 Docker 镜像 myregistry.com/myapp:v2 导入到 OpenShift 中，并自动为其创建新的 ImageStreamTag myapp:v2。

接下来，我们可以使用 oc tag 命令将 myapp:v1 关联到 myapp:v2，示例如下：

oc tag myapp:v1 myapp:v2

这个命令会将已存在的 myapp:v1 ImageStreamTag 关联到新的 Docker 镜像 myapp:v2，并将新的 ImageStreamTag myapp:v2 添加到 ImageStream myapp 中。

现在，myapp:v2 和 myapp:v1 都将指向同一个 Docker 镜像。如果我们使用 oc get istag 命令查看 myapp ImageStream 中的标记，我们将会看到两个标记，分别为 myapp:v1 和 myapp:v2，它们都指向同一个 Docker 镜像。

9.DeploymentConfig 如何关联 ImageStreamTag

在 OpenShift 中，DeploymentConfig 中的 pod 镜像通常会与 ImageStreamTag 关联。我们可以通过在 DeploymentConfig 中指定 ImageStreamTag 的名称来关联它们。

下面是一个 DeploymentConfig YAML 文件的示例，其中指定了 ImageStreamTag myapp:v1：

apiVersion: apps/v1
kind: DeploymentConfig
metadata:
  name: myapp
spec:
  replicas: 3
  selector:
    app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - name: myapp
          image: "myapp:latest" # 这里指定 ImageStreamTag 的名称
          ports:
            - containerPort: 8080
              protocol: TCP
      imagePullSecrets:
        - name: my-dockerhub-creds

在上面的示例中，image: "myapp:latest" 指定了 ImageStreamTag 的名称为 myapp:v1，DeploymentConfig 将使用此 ImageStreamTag 来创建 pod。

注意，myapp 在这里不是一个 Docker 镜像的名称，而是一个 ImageStream 的名称。在 OpenShift 中，我们可以通过 ImageStream 来管理 Docker 镜像，包括其标记（tag）和版本（version）。因此，我们在 DeploymentConfig 中指定的 myapp:latest 实际上是一个 ImageStreamTag 的名称，它指向了 myapp ImageStream 中的一个 Docker 镜像。

10.DeploymentConfig关联 ImageStreamTag，ImageStreamTag更新会触发pod更新吗

如果在关联的 ImageStreamTag 中更新了镜像，它将自动触发 DeploymentConfig 中的更新。

当 ImageStreamTag 更新后，OpenShift 会检测到更新并创建一个新的 ImageStreamImage。如果新的 ImageStreamImage 与前一个 ImageStreamImage 的 ID 不同，则 OpenShift 会触发一个新的部署（rolling-update）过程，以将现有 pod 更新到使用新的镜像。在部署期间，OpenShift 会按照指定的滚动升级策略（rolling-update strategy）逐步替换现有 pod，确保更新的过程对应用程序的可用性没有负面影响。

因此，我们可以通过更新 ImageStreamTag 来实现应用程序的更新和升级，而无需手动删除和重新创建 DeploymentConfig。

11.openshift ecr 更新imagestream

如果你需要在 OpenShift 上使用 AWS ECR（Elastic Container Registry）镜像仓库，并且想要在更新镜像时自动更新相关的 ImageStream，可以使用 oc import-image 命令。

以下是一个使用 oc import-image 命令更新 ImageStream 的示例：

oc import-image myimage --from=012345678910.dkr.ecr.us-west-2.amazonaws.com/myimage:latest --confirm

其中：

  • myimage 是要创建或更新的 ImageStream 名称。
  • 012345678910.dkr.ecr.us-west-2.amazonaws.com 是你的 ECR 镜像仓库地址。
  • latest 是要导入的镜像标签。

使用 --confirm 选项确认导入操作。

使用该命令将会创建或更新名为 myimage 的 ImageStream，该 ImageStream 将包含从 ECR 镜像仓库导入的镜像。此后，当 ECR 中的 latest 镜像标签更新时，使用 oc import-image 命令可以更新 ImageStream 中的相关信息，确保在 OpenShift 上使用的镜像与 ECR 中的镜像保持同步。

12.oc set image-lookup 作用

oc set image-lookup 命令是 OpenShift 中的一个高级命令，用于在 DeploymentConfig 和 Deployment 等资源对象中查找镜像标签或 Docker 镜像名称，并将它们转换为 ImageStreamTag 或 ImageStreamImage 资源对象的引用。

oc set image-lookup 命令的作用是，将部署配置文件中引用的镜像标签或 Docker 镜像名称自动转换为 ImageStreamTag 或 ImageStreamImage 引用，从而实现在 OpenShift 集群中部署应用程序时自动使用最新版本的镜像。

oc set image-lookup 命令的语法如下：

oc set image-lookup <resource_type> <resource_name> [--local=true|false] [--overwrite] [--namespace=<namespace>] [--as=<username>]

其中：

  • <resource_type> 和 <resource_name> 指定要更新的资源对象的类型和名称。
  • --local 参数指定是否使用本地 ImageStream 中的镜像进行替换，默认为 false，即使用远程镜像。
  • --overwrite 参数指定是否覆盖现有的镜像引用，默认为 false，即不覆盖现有的镜像引用。
  • --namespace 参数指定要使用的命名空间，默认为当前命名空间。
  • --as 参数指定执行命令的用户身份。

14.oc set image-lookup 具体的例子

假设我们有一个名为 myapp 的 DeploymentConfig，定义如下：

apiVersion: apps.openshift.io/v1
kind: DeploymentConfig
metadata:
  name: myapp
  labels:
    app: myapp
spec:
  replicas: 1
  selector:
    app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - name: myapp
          image: docker.io/myregistry/myapp:1.0.0
          ports:
            - containerPort: 8080

该 DeploymentConfig 使用 Docker 镜像 docker.io/myregistry/myapp:1.0.0 进行部署。现在我们希望自动更新镜像版本，可以使用 oc set image-lookup 命令自动查找最新的镜像版本并进行更新。

oc set image-lookup dc/myapp --local=true --overwrite

该命令将自动在本地 ImageStream 中查找与 Docker 镜像 docker.io/myregistry/myapp:1.0.0 匹配的镜像标签，并将其替换为 ImageStreamTag 或 ImageStreamImage 资源对象的引用。如果本地 ImageStream 中没有匹配的镜像标签，则使用远程镜像进行替换。

在执行命令后，DeploymentConfig 中的 image 字段将被自动更新为最新的镜像版本，例如：

apiVersion: apps.openshift.io/v1
kind: DeploymentConfig
metadata:
  name: myapp
  labels:
    app: myapp
spec:
  replicas: 1
  selector:
    app: myapp
  template:
    metadata:
      labels:
        app: myapp
    spec:
      containers:
        - name: myapp
          image: image-registry.openshift-image-registry.svc:5000/myproject/myapp@sha256:4d98f16b0988cde61a7d903c123f97a17fbaf8b3d0767b542d2b25ca47b3edc3
          ports:
            - containerPort: 8080

可以看到，image 字段被更新为 ImageStreamTag 或 ImageStreamImage 资源对象的引用。

15.如果不用 oc set image-lookup 会有什么影响吗？

如果不使用 oc set image-lookup 来设置 DeploymentConfig 或 Deployment 的镜像来源，它们将默认从 Docker Hub 或者其他公共的 Docker 镜像仓库中获取镜像。这可能会导致一些问题，比如：

  • 无法控制镜像更新的节奏：如果不指定 ImageStream，就无法控制应用程序的镜像何时被更新，从而可能会导致不可预期的行为。
  • 无法保证镜像的一致性：如果不使用 ImageStream 来管理应用程序的镜像，可能会导致在不同的环境中使用了不同版本的镜像，从而导致应用程序在不同环境中出现不同的行为。
  • 无法追踪镜像历史：如果不使用 ImageStream 来管理应用程序的镜像，就无法查看应用程序所使用的镜像的历史记录，也无法回滚到之前的版本。

因此，在 OpenShift 中，推荐使用 ImageStream 来管理应用程序的镜像，并使用 oc set image-lookup 来为 DeploymentConfig 或 Deployment 明确指定镜像来源。这样可以确保应用程序的镜像是可控的、一致的，并且可以追踪历史记录。

16.DeploymentConfig 直接指定ImageStream，是不是就不用oc set image-lookup 了？

是的，如果您直接在 DeploymentConfig 中指定了 ImageStream，就不需要使用 oc set image-lookup。在这种情况下，DeploymentConfig 将从 ImageStream 中获取镜像，而不是从 Docker Hub 或者其他公共的 Docker 镜像仓库中获取镜像。

需要注意的是，如果您直接在 DeploymentConfig 中指定了 ImageStream，但是 ImageStream 中的镜像没有更新，那么即使您执行了 oc rollout latest 或者 oc deploy <deployment-config> 命令，DeploymentConfig 也不会更新镜像。因此，为了确保 DeploymentConfig 与 ImageStream 中的镜像保持同步，您可能需要使用 oc set image-lookup 命令来定期更新 DeploymentConfig。

17.给一个 DeploymentConfig 直接指定ImageStream的例子

下面是一个示例 DeploymentConfig，其中直接指定了一个名为 my-imagestream:latest 的 ImageStream：

apiVersion: apps.openshift.io/v1
kind: DeploymentConfig
metadata:
  name: my-deployment
spec:
  replicas: 1
  selector:
    app: my-app
  template:
    metadata:
      labels:
        app: my-app
    spec:
      containers:
      - name: my-container
        image: my-imagestream:latest
        ports:
        - containerPort: 8080

在这个示例中，spec.template.spec.containers[].image 字段直接指定了 my-imagestream:latest。当 my-deployment 对应的 DeploymentConfig 被创建或者更新时，将从 my-imagestream 中获取最新的 latest 标签的镜像。

18.当 DeploymentConfig 指定ImageStream时，ImageStream更新，会触发DeploymentConfig更新pod吗？

当 DeploymentConfig 指定 ImageStream 时，ImageStream 的更新并不会直接触发 DeploymentConfig 更新 pod。

如果需要触发 DeploymentConfig 更新 pod，可以通过更新 DeploymentConfig 的 YAML 配置来实现，例如通过修改 spec.triggers 中的 ImageChangeParams 触发器来指定更新策略。在触发器的 latestImage 字段中指定最新的 ImageStreamTag 名称，DeploymentConfig 会检测该 ImageStreamTag 是否有更新，如果有更新则会重新部署 pod。

另外，也可以手动更新 DeploymentConfig，例如使用命令 oc rollout latest dc/<dc-name>，该命令会检查最新的 ImageStreamTag 是否有更新，如果有则会重新部署 pod。

19.当 DeploymentConfig 指定 ImageStream 时，oc set image-lookup 会强制DeploymentConfig更新pod吗

当 DeploymentConfig 指定了 ImageStream 并使用 oc set image-lookup 命令时，执行该命令会将 ImageStreamImage 的引用设置为 DeploymentConfig 的 ImageName 字段，从而强制 DeploymentConfig 更新相应的 pod，以确保使用最新的镜像。

在 DeploymentConfig 中指定了 ImageStream 后，执行 oc set image-lookup 命令会更新 ImageStreamImage 的引用，从而使 DeploymentConfig 强制更新相关的 pod。

因此，执行 oc set image-lookup 命令后，会自动触发 DeploymentConfig 更新 pod，无需手动执行任何其他命令。