附註

要瞭解有關如何使用 Container Registry CLI 的更多資訊，請參閱 IBM Cloud Container Registry 入門。

當 ibmcloud CLI 及 container-registry CLI 外掛程式的更新可用時，您會在指令行收到通知。 確保您的 CLI 保持更新，以便您可以使用所有可用的指令和選項。 如果您要檢視 container-registry CLI 外掛程式的目前版本，請執行 ibmcloud plugin list 指令。

如需部分 Container Registry 指令所需的 IAM 平台及服務存取角色的相關資訊，請參閱 管理 Container Registry。

請不要將個人資訊放在容器映像檔、名稱空間的名稱、說明欄位或任何映像檔配置資料（例如，映像檔名稱或映像檔標籤）中。

如果 Container Registry 指令失敗，且錯誤指出它們不是已登錄的指令，請參閱 為何 cr 指令無法指出它們未登錄? 以取得協助。 如果指令無法指出您未登入，請參閱 為何我無法登入 Container Registry? 以取得協助。

必要條件

無

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--scope SCOPE

若要將帳戶設定為範圍，請使用 "*" 作為值。

若要設定命名空間、儲存庫、摘要或標籤為作用域，請以下列其中一種格式輸入數值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

您要豁免的安全問題類型。 若要尋找有效的問題類型，請執行 ibmcloud cr exemption-types。

--issue-id ISSUE_ID

您要豁免的安全問題 ID。 若要尋找問題 ID，請執行 ibmcloud cr va <image>，其中 <image> 是您的影像名稱，並使用漏洞 ID 或組態問題 ID 列中的相關值。

--output json, -o json

(可選）以 JSON 格式輸出清單。

範例

對於 CVE-2018-17929 儲存庫中的所有映像檔，建立 ID 為 us.icr.io/birds/bluebird 之 CVE 的 CVE 豁免。

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

建立 ID 為 CVE-2018-17929 之 CVE 的帳戶層面 CVE 豁免。

ibmcloud cr exemption-add --scope "*" --issue-type cve --issue-id CVE-2018-17929

對於標籤為 application_configuration:nginx.ssl_protocols 的單一映像檔，建立問題 us.icr.io/birds/bluebird:1 的配置問題豁免。

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird:1 --issue-type configuration --issue-id application_configuration:nginx.ssl_protocols

為問題 application_configuration:nginx.ssl_protocols 建立單一影像的設定問題豁免，摘要 us.icr.io/birds/bluebird@sha256:101010101010。

ibmcloud cr exemption-add --scope us.icr.io/birds/bluebird@sha256:101010101010 --issue-type configuration --issue-id application_configuration:nginx.ssl_protocols

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--scope SCOPE

（選用）僅列出適用於此範圍的豁免。

若要設定命名空間、儲存庫、摘要或標籤為作用域，請以下列其中一種格式輸入數值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--output json, -o json

(可選）以 JSON 格式輸出清單。

範例

列出您適用於 birds/bluebird 儲存庫中影像的所有安全問題豁免。 輸出包括帳戶範圍的豁免、以 birds 名稱空間為範圍的豁免，以及以 birds/bluebird 儲存庫為範圍的豁免。 輸出不包括任何以 birds/bluebird 儲存庫內特定標籤為範圍的豁免。

ibmcloud cr exemption-list --scope birds/bluebird

列出您所有適用於 birds/bluebird@sha256:101010101010 摘要中影像的安全問題豁免。 輸出包括全帳戶豁免、限定範圍為 birds 名稱空間的豁免，以及限定範圍為 birds/bluebird 儲存庫及 birds/bluebird@sha256:101010101010 摘要的豁免。 輸出不包括任何以 birds/bluebird 儲存庫內特定標籤為範圍的豁免。

ibmcloud cr exemption-list --scope birds/bluebird@sha256:101010101010

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--scope SCOPE

若要將帳戶設定為範圍，請使用 "*" 作為值。

若要設定命名空間、儲存庫、摘要或標籤為作用域，請以下列其中一種格式輸入數值：

• namespace
• namespace/repository
• namespace/repository:tag
• namespace/repository@digest

--issue-type ISSUE_TYPE

您要移除的安全問題的豁免問題類型。 若要尋找豁免的問題類型，請執行 ibmcloud cr exemption-list。

--issue-id ISSUE_ID

您要移除之安全問題的豁免 ID。 若要尋找豁免的問題 ID，請執行 ibmcloud cr exemption-list。

範例

對於 CVE-2018-17929 儲存庫中的所有映像檔，刪除 ID 為 us.icr.io/birds/bluebird 之 CVE 的 CVE 豁免。

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird --issue-type cve --issue-id CVE-2018-17929

刪除 ID 為 CVE-2018-17929 之 CVE 的帳戶層面 CVE 豁免。

ibmcloud cr exemption-rm --scope "*" --issue-type cve --issue-id CVE-2018-17929

對於標籤為 application_configuration:nginx.ssl_protocols 的單一映像檔，刪除問題 us.icr.io/birds/bluebird:1 的配置問題豁免。

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird:1 --issue-type configuration --issue-id application_configuration:nginx.ssl_protocols

刪除問題 application_configuration:nginx.ssl_protocols 的設定問題豁免，適用於具有摘要 us.icr.io/birds/bluebird@sha256:101010101010 的單一影像。

ibmcloud cr exemption-rm --scope us.icr.io/birds/bluebird@sha256:101010101010 --issue-type configuration --issue-id application_configuration:nginx.ssl_protocols

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--output json, -o json

(可選）以 JSON 格式輸出清單。

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--format FORMAT

（選用）使用 Go 範本來將輸出元素格式化。 如需相關資訊，請參閱 格式化及過濾 Container Registry CLI 輸出。

--quiet, -q

(選用）每張影像都會以格式列出：repository@digest

--output json, -o json

(可選）以 JSON 格式輸出清單。

--restrict RESTRICTION

(可選）限制輸出，僅顯示指定命名空間或儲存庫中的影像。

--include-ibm

（選用）將 IBM 提供的公用映像檔包括在輸出中。 依預設，只會列出專用映像檔。 您只能在廣域登錄中檢視 IBM提供的映像檔。

--no-va

(選用) 排除輸出中的 Vulnerability Advisor 安全狀態結果。 如果您不需要安全狀態結果作為 ibmcloud cr image-digests 輸出的一部分，則可以使用此選項來提高效能。

--va

(選用) 在輸出中包含 Vulnerability Advisor 安全狀態結果。 使用此選項可確保您已備妥 IBM Cloud Container Registry CLI 外掛程式 1.0.0。 您可以搭配使用 --va 選項與 --restrict 選項，只接收您需要的資訊。

範例

以 repository@digest 格式顯示 birds 名稱空間中的所有映像檔 (包括未標記的映像檔)。

ibmcloud cr image-digests --restrict birds --quiet

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--format FORMAT

（選用）使用 Go 範本來將輸出元素格式化。 如需相關資訊，請參閱 格式化及過濾 Container Registry CLI 輸出。

IMAGE

您要取得其報告的映像檔名稱。 您可以藉由在指令中列出每一個映像檔，並以空格隔開每一個名稱，來檢查多個映像檔。

您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或標籤 <dns>/<namespace>/<repo>:<tag> 識別影像。 其中 <dns> 是網域名稱，<namespace> 是命名空間，<repo> 是儲存庫，<digest> 是摘要，<tag> 是標籤。

若要尋找映像檔的名稱，請執行下列其中一個指令:

• 若要透過摘要來識別映像檔，請執行 ibmcloud cr image-digests 指令。 結合 儲存庫 直欄 (repository) 和 摘要 直欄 (digest) 的內容 (以 at (@) 符號區隔)，以 repository@digest 格式建立映像檔名稱。
• 若要依標籤識別映像檔，請執行 ibmcloud cr image-list 指令。 結合 儲存庫 直欄 (repository) 和 標籤 直欄 (tag) (以冒號 (:) 區隔) 的內容，以 repository:tag 格式建立映像檔名稱。 如果映像檔名稱中未指定標籤，則依預設會刪除以 latest 標記的映像檔。

範例

使用下列格式化指令，顯示影像 us.icr.io/birds/bluebird:1 的外露連接埠詳細資訊。

ibmcloud cr image-inspect  --format "{{ .Config.ExposedPorts }}" us.icr.io/birds/bluebird:1

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--format FORMAT

（選用）使用 Go 範本來將輸出元素格式化。 如需相關資訊，請參閱 格式化及過濾 Container Registry CLI 輸出。

--quiet, -q

(選用）每張影像都會以格式列出：repository:tag

--restrict RESTRICTION

(可選）限制輸出，僅顯示指定命名空間或儲存庫中的影像。

--include-ibm

（選用）將 IBM 提供的公用映像檔包括在輸出中。 依預設，只會列出專用映像檔。 您只能在廣域登錄中檢視 IBM提供的映像檔。

--no-trunc

(選用) 以長格式傳回映像檔摘要。

--show-type

（選用）顯示映像檔資訊清單類型。

--no-va

(選用) 排除輸出中的 Vulnerability Advisor 安全狀態結果。 如果您不需要安全狀態結果作為 ibmcloud cr image-list 輸出的一部分，則可以使用此選項來提高效能。

--va

(選用) 在輸出中包含 Vulnerability Advisor 安全狀態結果。 使用此選項可確保您已備妥 IBM Cloud Container Registry CLI 外掛程式 1.0.0。 您可以搭配使用 --va 選項與 --restrict 選項，只接收您需要的資訊。

--output json, -o json

(可選）以 JSON 格式輸出清單。

範例

以 repository:tag 的格式顯示 birds 命名空間中的影像，而不截斷影像摘要。

ibmcloud cr image-list --restrict birds --quiet --no-trunc

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--force, -f

（選用）強制執行指令而不產生使用者提示。

--output json, -o json

(可選）輸出包含清理未標記影像結果的 JSON。 此選項必須與 --force 搭配使用。

--restrict

(選用) 將清除限制為僅在指定名稱空間或儲存庫中未標記的映像檔。

範例

刪除 birds 名稱空間中所有未標記的映像檔，並以 JSON 格式輸出結果。

ibmcloud cr image-prune-untagged [--force | -f [--json]] --restrict birds

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

IMAGE

您要從垃圾筒中還原之映像檔的名稱。

若要在垃圾桶中找到您的影像名稱，請執行 ibmcloud cr trash-list 指令。

您可以使用標籤或摘要來識別映像檔。 要還原的映像檔可以由摘要 <dns>/<namespace>/<repo>@<digest> 參照，這會還原相同儲存庫中的摘要及其所有標籤，或由標籤 <dns>/<namespace>/<repo>:<tag> 參照。 其中 <dns> 是網域名稱，<namespace> 是命名空間，<repo> 是儲存庫，<digest> 是摘要，<tag> 是標籤。

映像檔可在垃圾筒中儲存 30 天。

範例

若要還原映像檔 us.icr.io/birds/bluebird:1，請執行下列指令：

ibmcloud cr image-restore us.icr.io/birds/bluebird:1

如需如何使用 ibmcloud cr image-restore 指令的相關資訊，請參閱還原映像檔。

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

IMAGE

您要刪除之映像檔的名稱。 您可以藉由在指令中列出每一個映像檔，並以空格隔開每一個名稱，來同時刪除多個映像檔。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或標籤 <dns>/<namespace>/<repo>:<tag> 識別影像。 其中 <dns> 是網域名稱，<namespace> 是命名空間，<repo> 是儲存庫，<digest> 是摘要，<tag> 是標籤。

映像檔可在垃圾筒中儲存 30 天。

若要尋找映像檔的名稱，請執行下列其中一個指令:

• 若要透過摘要來識別映像檔，請執行 ibmcloud cr image-digests 指令。 結合 儲存庫 直欄 (repository) 和 摘要 直欄 (digest) 的內容 (以 at (@) 符號區隔)，以 repository@digest 格式建立映像檔名稱。
• 若要依標籤識別映像檔，請執行 ibmcloud cr image-list 指令。 結合 儲存庫 直欄 (repository) 和 標籤 直欄 (tag) (以冒號 (:) 區隔) 的內容，以 repository:tag 格式建立映像檔名稱。 如果映像檔名稱中未指定標籤，則依預設會刪除以 latest 標記的映像檔。

範例

刪除映像檔 us.icr.io/birds/bluebird:1。

ibmcloud cr image-rm us.icr.io/birds/bluebird:1

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

SOURCE_IMAGE

來源映像檔的名稱。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或依標籤 <dns>/<namespace>/<repo>:<tag> 來識別來源映像檔。 其中 <dns> 是網域名稱，<namespace> 是命名空間，<repo> 是儲存庫，<digest> 是摘要，<tag> 是標籤。

TARGET_IMAGE

目標映像檔的名稱。TARGET_IMAGE 必須採用 repository:tag 格式，例如 us.icr.io/namespace/image:latest。

範例

新增另一個標籤參考 latest，到圖片 us.icr.io/birds/bluebird:1。

ibmcloud cr image-tag  us.icr.io/birds/bluebird:1 us.icr.io/birds/bluebird:latest

將映像檔 us.icr.io/birds/bluebird:peck 複製到相同名稱空間 birds/pigeon 中的另一個儲存庫。

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/birds/pigeon:peck

將映像檔 us.icr.io/birds/bluebird:peck 複製到您有存取權的另一個名稱空間 animals。

ibmcloud cr image-tag us.icr.io/birds/bluebird:peck us.icr.io/animals/dog:bark

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

IMAGE

您要移除標籤的映像檔名稱。 您可以同時從多個映像檔中刪除標籤，方法是在指令中列出每一個映像檔，並在每一個名稱之間加上一個空格。IMAGE 必須採用 repository:tag 格式，例如 us.icr.io/namespace/image:latest。

若要尋找映像檔的名稱，請執行 ibmcloud cr image-list。 結合 儲存庫 直欄 (repository) 和 標籤 直欄 (tag) (以冒號 (:) 區隔) 的內容，以 repository:tag 格式建立映像檔名稱。 如果映像檔名稱中未指定標籤，指令會失敗。

範例

從映像檔 1 移除標籤 us.icr.io/birds/bluebird:1。

ibmcloud cr image-untag us.icr.io/birds/bluebird:1

必要條件

無

必要條件

無

指令選項

CLIENT

(選用) 選取您要登入的用戶端。 有效值為 docker 和 podman。 如果未使用此選項且已安裝 Docker，則預設值為 docker; 如果未安裝 Docker，則預設值為 podman。

範例

若要使用 Podman 登入註冊表，請執行下列指令。

ibmcloud cr login --client podman

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

IMAGE

您要檢查資訊清單的映像檔名稱。 您可以使用摘要 <dns>/<namespace>/<repo>@<digest> 或標籤 <dns>/<namespace>/<repo>:<tag> 識別影像。 其中 <dns> 是網域名稱，<namespace> 是命名空間，<repo> 是儲存庫，<digest> 是摘要，<tag> 是標籤。

若要尋找映像檔的名稱，請執行下列其中一個指令:

• 若要透過摘要來識別映像檔，請執行 ibmcloud cr image-digests 指令。 結合 儲存庫 直欄 (repository) 和 摘要 直欄 (digest) 的內容 (以 at (@) 符號區隔)，以 repository@digest 格式建立映像檔名稱。
• 若要依標籤識別映像檔，請執行 ibmcloud cr image-list 指令。 結合 儲存庫 直欄 (repository) 和 標籤 直欄 (tag) (以冒號 (:) 區隔) 的內容，以 repository:tag 格式建立映像檔名稱。

--quiet, -q

（選用）減少輸出，僅顯示基本元素。

範例

若要檢視映像檔 us.icr.io/birds/bluebird:1 的資訊清單內容，請執行下列指令：

ibmcloud cr manifest-inspect us.icr.io/birds/bluebird:1

必要條件

若要進一步瞭解必要許可權，請參閱 平台管理角色 及 用於配置 Container Registry的存取角色。

指令選項

NAMESPACE

您要新增的名稱空間。 此名稱空間在相同地區的所有 IBM Cloud 帳戶中必須是唯一的。 名稱空間必須有 4 - 30 個字元，且只能包含小寫字母、數字、連字號 (-) 及底線 (_)。 名稱空間的開頭和結尾必須是字母或數字。

請不要將個人資訊放在名稱空間的名稱中。

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(可選）指定要新增命名空間的資源群組的名稱或 ID。 如果您未設定此選項，則會使用目標資源群組。 如果您未設定此選項，且資源群組未設為目標，則會使用帳戶的預設資源群組。

範例

建立名稱為 birds 的名稱空間，並將它新增至資源群組 beaks。

ibmcloud cr namespace-add -g beaks birds

必要條件

若要進一步瞭解必要許可權，請參閱 平台管理角色 及 用於配置 Container Registry的存取角色。

指令選項

-g (RESOURCE_GROUP_NAME | RESOURCE_GROUP_ID)

(可選）指定要為其指定命名空間的資源群組的名稱或 ID。 如果您未設定此選項，則會使用目標資源群組。

NAMESPACE

要指定給資源群組的命名空間。

範例

將名稱為 birds 的名稱空間指派給資源群組 beaks。

ibmcloud cr namespace-assign -g beaks birds

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--verbose, -v

(選用) 列出所有名稱空間，並包括資源群組及名稱空間建立日期的相關資訊。

--output json, -o json

(可選）以 JSON 格式輸出清單。

範例

檢視所有名稱空間的清單，包括資源群組及建立日期的相關資訊。

ibmcloud cr namespace-list  -v

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

NAMESPACE

您要移除的名稱空間。

--force, -f

（選用）強制執行指令而不產生使用者提示。

範例

移除命名空間 birds。

ibmcloud cr namespace-rm birds

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--output json, -o json

(可選）以 JSON 格式輸出清單。

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

PLAN

（選用）您要升級到的定價方案名稱。 如果未指定 PLAN，則預設值為 standard。

範例

升級為標準定價方案。

ibmcloud cr plan-upgrade standard

必要條件

• 您必須設定 IBM Cloud Monitoring，請參閱 IBM Cloud Monitoring入門指導教學。
• 針對平台度量值啟用 IBM Cloud Monitoring 實例。
• 若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--enable

(可選）啟用帳戶的設定。

--disable

(可選）停用帳戶的設定。

--status

(選用）顯示您的帳戶是否已啟用設定。

範例

啟用帳戶的平台度量值。

ibmcloud cr platform-metrics --enable

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--enable

(選用) 防止映像檔透過您帳戶的公用網路連線取回或推送。

--disable

(選用) 透過您帳戶的公用網路連線來恢復映像檔取回或推送。

--status

(選用) 檢查是否阻止使用公用連線來推送映像檔或取回您的帳戶。

範例

防止映像檔透過您帳戶的公用網路連線取回或推送。

ibmcloud cr private-only --enable

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--output json, -o json

(可選）以 JSON 格式輸出清單。

必要條件

若要瞭解所需權限的詳細資訊，請參閱 設定 Container Registry 的存取角色。

指令選項

--traffic TRAFFIC

（選用）將資料流量配額變更為指定的值 (MB)。 如果您未獲授權，無法設定資料流量，或是設定了超出現行定價方案的值，則作業會失敗。

--storage STORAGE

（選用）將儲存空間配額變更為指定的值 (MB)。 如果您未獲授權，無法設定儲存空間配額，或是設定了超出現行定價方案的值，則作業會失敗。

範例

將取回資料流量的配額限制設為 7000 MB，並將儲存空間設為 600 MB。

ibmcloud cr quota-set --traffic 7000 --storage 600

必要條件

無

必要條件

無

指令選項

REGION

(可選）您目標區域的名稱，例如 us-south。 如需相關資訊，請參閱地區。

範例

將「美國南部」地區設為目標。

ibmcloud cr region-set us-south

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--output json, -o json

(可選）以 JSON 格式輸出清單。

範例

列出您帳戶中的保留原則。

ibmcloud cr retention-policy-list

如需如何使用 ibmcloud cr retention-policy-list 指令的相關資訊，請參閱保留映像檔。

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

NAMESPACE

您要為其建立原則的名稱空間。

--retain-untagged

(可選）處理保留政策時，保留所有未標記的影像。 只會分析已標記的映像檔，如果映像檔不符合準則，則會刪除它們。 如果未指定選項，則會分析所有已標記及未標記的映像檔，如果映像檔不符合準則，則會刪除它們。

--force, -f

（選用）強制執行指令而不產生使用者提示。

--images

決定在指定的名稱空間中每個儲存庫內要保留多少個映像檔。 將保留最新的映像檔。 映像檔的經歷時間取決於其建置日期。IMAGECOUNT 是您要在名稱空間的每一個儲存庫中保留的映像檔數目。 若要將一個政策回復到預設狀態，即保留所有圖像設定 IMAGECOUNT 至 All。

範例

設定一個原則，以在 birds 名稱空間中，保留每個儲存庫中最新的 20 個映像檔。

ibmcloud cr retention-policy-set --images 20 birds

將原則設回預設狀態，以在名稱空間 birds 中保留所有映像檔。

ibmcloud cr retention-policy-set --images All birds

如需如何使用 ibmcloud cr retention-policy-set 指令的相關資訊，請參閱保留映像檔。

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

NAMESPACE

要清除的名稱空間。

--force, -f

（選用）強制執行指令而不產生使用者提示。

--output json, -o json

（選用）包含清除名稱空間結果的輸出 JSON。 此選項必須與 --force 搭配使用。

--retain-untagged

(可選）處理保留政策時，保留所有未標記的影像。 只會分析已標記的映像檔，如果映像檔不符合準則，則會刪除它們。 如果未指定選項，則會分析所有已標記及未標記的映像檔，如果映像檔不符合準則，則會刪除它們。

--images

決定在指定的名稱空間中每個儲存庫內要保留多少個映像檔。 將保留最新的映像檔。 映像檔的經歷時間取決於其建置日期。IMAGECOUNT 是您要在名稱空間的每一個儲存庫中保留的映像檔數目。

範例

在 birds 名稱空間中，保留每個儲存庫中最新的 20 個映像檔。

ibmcloud cr retention-run --images 20 birds

如需如何使用 ibmcloud cr retention-run 指令的相關資訊，請參閱保留映像檔。

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

--restrict NAMESPACE

（選用）限制輸出，只顯示所指定名稱空間中的映像檔。

--output json, -o json

（選用）包含垃圾筒內容之詳細資料的輸出 JSON。

範例

顯示 birds 命名空間中垃圾桶的圖片。

ibmcloud cr trash-list --restrict birds

必要條件

無。

必要條件

無。

指令選項

VERSION

您要使用的 Vulnerability Advisor 版本。 唯一有效的值是 v4。

範例

若要將「漏洞」版本設為第 4 版，請執行下列指令:

ibmcloud cr va-version-set v4

必要條件

要了解有關所需權限的更多信息，請參閱 使用 Container Registry 的存取角色。

指令選項

IMAGE

您要取得其報告的映像檔名稱。 報告會指出映像檔是否有任何已知的套件漏洞。 您可以藉由在指令中列出每一個映像檔，並以空格隔開每一個名稱，來同時要求多個映像檔的報告。

若要尋找映像檔的名稱，請執行 ibmcloud cr image-list。 結合 儲存庫 直欄 (repository) 和 標籤 直欄 (tag) (以冒號 (:) 區隔) 的內容，以 repository:tag 格式建立映像檔名稱。 如果映像檔名稱中未指定標籤，則報告會評量以 latest 標記的映像檔。

如需受支援 Docker 基本映像檔的相關資訊，請參閱 有漏洞的套件。

如需相關資訊，請參閱使用 Vulnerability Advisor 管理映像檔安全。

--extended, -e

（選用）指令輸出會針對有漏洞的套件顯示有關修正程式的其他資訊。

--vulnerabilities, -v

（選用）指令輸出限制為只顯示漏洞。

--configuration-issues, -c

（選用）指令輸出限制為只顯示配置問題。

--output FORMAT, -o FORMAT

（選用）以選擇的格式傳回指令輸出。 預設格式為 text。

支援的格式如下：

• text
• json

範例

檢視映像檔的標準漏洞評量報告。

ibmcloud cr vulnerability-assessment us.icr.io/birds/bluebird:1

檢視 us.icr.io/birds/bluebird:1 映像檔的漏洞評量報告（JSON 格式），並僅顯示漏洞。

ibmcloud cr vulnerability-assessment --vulnerabilities  --output json us.icr.io/birds/bluebird:1