18.4. 将引用附加到镜像标签

流程

1. 输入以下命令标记 OCI 介质工件：

   $ podman tag <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

2. 将工件推送到 Red Hat Quay registry。例如：

   $ podman push <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

3. 输入以下命令，使用带有 oras 的 OCI 1.1 引用 API 模式来附加清单：

   $ oras attach --artifact-type <MIME_type> --distribution-spec v1.1-referrers-api <myartifact_image> \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag> \
   <example_file>.txt

   输出示例

   -spec v1.1-referrers-api quay.io/testorg3/myartifact-image:v1.0 hi.txt
   ✓ Exists    hi.txt                                                               3/3  B 100.00%     0s
     └─ sha256:98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4
   ✓ Exists    application/vnd.oci.empty.v1+json                                    2/2  B 100.00%     0s
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                       723/723  B 100.00%  677ms
     └─ sha256:31c38e6adcc59a3cfbd2ef971792aaf124cbde8118e25133e9f9c9c4cd1d00c6
   Attached to [registry] quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   Digest: sha256:31c38e6adcc59a3cfbd2ef971792aaf124cbde8118e25133e9f9c9c4cd1d00c6

4. 输入以下命令使用 OCI 1.1 引用器 标签 模式附加清单：

   $ oras attach --artifact-type <MIME_type> --distribution-spec v1.1-referrers-tag \
   <myartifact_image> <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag> \
   <example_file>.txt

   输出示例

   ✓ Exists    hi.txt                                                             3/3  B 100.00%     0s
     └─ sha256:98ea6e4f216f2fb4b69fff9b3a44842c38686ca685f3f55dc48c5d3fb1107be4
   ✓ Exists    application/vnd.oci.empty.v1+json                                  2/2  B 100.00%     0s
     └─ sha256:44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a
   ✓ Uploaded  application/vnd.oci.image.manifest.v1+json                     723/723  B 100.00%  465ms
     └─ sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383
   Attached to [registry] quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   Digest: sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383

5. 输入以下命令 使用标签 模式发现工件的引用器：

   $ oras discover --insecure --distribution-spec v1.1-referrers-tag \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

   输出示例

   quay.io/testorg3/myartifact-image@sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   └── doc/example
       └── sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383

6. 输入以下命令使用 API 模式发现工件的引用器：

   $ oras discover --distribution-spec v1.1-referrers-api \
   <quay-server.example.com>/<organization_name>/<repository>/<image_name>:<tag>

   输出示例

   Discovered 3 artifacts referencing v1.0
   Digest: sha256:db440c57edfad40c682f9186ab1c1075707ce7a6fdda24a89cb8c10eaad424da
   
   Artifact Type   Digest
                   sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383
                   sha256:22b7e167793808f83db66f7d35fbe0088b34560f34f8ead36019a4cc48fd346b
                   sha256:bb2b7e7c3a58fd9ba60349473b3a746f9fe78995a88cb329fc2fd1fd892ea4e4

7. 可选。您还可以使用 /v2/<organization_name>/<repository_name>/referrers/<sha256_digest& gt; 端点来发现引用器。要实现此目的，您必须在 config.yaml 文件中生成 v2 API 令牌并设置 FEATURE_REFERRERS_API: true。

   1. 更新 config.yaml 文件，使其包含 FEATURE_REFERRERS_API 字段。例如：

      # ...
      FEATURE_REFERRERS_API: true
      # ...

   2. 输入以下命令对凭证进行 Base64 编码：

      $ echo -n '<username>:<password>' | base64

      输出示例

      abcdeWFkbWluOjE5ODlraWROZXQxIQ==

   3. 输入以下命令使用 base64 编码的令牌，并将 URL 端点改为 Red Hat Quay 服务器：

      $ curl --location '<quay-server.example.com>/v2/auth?service=<quay-server.example.com>&scope=repository:quay/listocireferrs:pull,push' --header 'Authorization: Basic <base64_username:password_encode_token>' -k | jq

      输出示例

      {
        "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6Ijl5RWNtWmdiZ0l6czBBZW16emhTMHM1R0g2RDJnV2JGUTdUNGZYand4MlUiLCJ0eXAiOiJKV1QifQ..."
      }

8. 输入以下命令使用 v2 API 令牌列出存储库下清单的 OCI 引用器：

   $ GET https://<quay-server.example.com>/v2/<organization_name>/<repository_name>/referrers/sha256:0de63ba2d98ab328218a1b6373def69ec0d0e7535866f50589111285f2bf3fb8
   --header 'Authorization: Bearer <v2_bearer_token> -k | jq

   输出示例

   {
     "schemaVersion": 2,
     "mediaType": "application/vnd.oci.image.index.v1+json",
     "manifests": [
       {
         "mediaType": "application/vnd.oci.image.manifest.v1+json",
         "digest": "sha256:2d4b54201c8b134711ab051389f5ba24c75c2e6b0f0ff157fce8ffdfe104f383",
         "size": 793
       },
     ]
   }