第 6 章 Image scanning by using the roxctl CLI


You can scan images stored in image registries, including cluster local registries such as the OpenShift Container Platform integrated image registry by using the roxctl CLI.

6.1. Scanning images by using a remote cluster

By specifying the appropriate cluster in the delegated scanning configuration or through the cluster parameter described in the following procedure, you can scan images from cluster local registries by using a remote cluster.

重要

For more information about how to configure delegated image scanning, see Configuring delegated image scanning.

Procedure

  • Run the following command to scan the specified image in a remote cluster:

    $ roxctl image scan \
      --image=<image_registry>/<image_name> \
      --cluster=<cluster_detail> \
      [flags]

    where:

    <image_registry>
    Specifies the registry where the image is located, for example, image-registry.openshift-image-registry.svc:5000/.
    image_name
    Specifies the name of the image that you want to scan.
    <cluster_detail>
    Specifies the name or ID of the remote cluster. For example, specify the name remote.
    [flags]
    Specifies the parameters to modify the behavior of the command. This is optional.

    Example output

    {
      "Id": "sha256:3f439d7d71adb0a0c8e05257c091236ab00c6343bc44388d091450ff58664bf9",
      "name": {
        "registry": "image-registry.openshift-image-registry.svc:5000",
        "remote": "default/image-stream",
        "tag": "latest",
        "fullName": "image-registry.openshift-image-registry.svc:5000/default/image-stream:latest"
      },
    [...]

    • Id is a unique identifier for the image that serves as a fingerprint for the image. It helps ensure the integrity and authenticity of the image.
    • registry is the location of the image registry where the image is stored.
    • remote is the remote path to the image.
    • tag is the version or tag associated with this image.
    • fullName is the complete name of the image, combining the registry, remote path, and tag.
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

关于红帽文档

Legal Notice

Theme

© 2026 Red Hat
返回顶部