Container Registry CLI 出力のフォーマットとフィルタリング

サポートされる IBM Cloud Container Registry コマンドでは、IBM Cloud® Container Registry の CLI 出力をフォーマット設定したりフィルタリングしたりできます。

デフォルトで、CLI 出力は、人間が読める形式で表示されます。 ただし、このビューでは、特にコマンドがプログラマチックに実行される場合、出力の使用能力が制限される可能性があります。 例えば、 ibmcloud cr image-list のCLI出力では、 Size フィールドを数値順にソートしたい場合があるかもしれませんが、コマンドは文字列の説明を返します。 container-registry CLI プラグインには、Go テンプレートを CLI 出力に適用するために使用できる format オプションが用意されています。 Goテンプレートは、 Goプログラミング言語の機能であり、CLI出力のカスタマイズに使用できます。

format オプションを次の 2 つの異なる方法で適用して、CLI 出力を変更できます。

• CLI 出力内のデータをフォーマット設定する。 例えば、 Created フィールドの出力を UNIX ® 時間から標準時間に変更できます。
• CLI 出力内のデータをフィルター操作する。 例えば、Go テンプレートの if gt 条件を使用することにより、イメージの詳細でフィルター操作してイメージの特定のサブセットを表示します。

フォーマット設定オプションには、以下の IBM Cloud Container Registry コマンドを使用します。 コマンドをクリックすると、使用可能なフィールドとそれらのデータ・タイプのリストが表示されます。

• ibmcloud cr image-digests コマンド
• ibmcloud cr image-list コマンド
• ibmcloud cr image-inspect コマンド

次のサンプル・コードは、フォーマット設定オプションとフィルター操作オプションの使用方法を示しています。

• 次の ibmcloud cr image-digests コマンドを実行すると、ダイジェストで参照される、タグが付いていないイメージすべてを表示します。

  ibmcloud cr image-digests --format '{{if not .Tags}}{{.Repository}}@{{.Digest}}{{end}}'
  

  次のメッセージは、コマンドの出力例です

  example-<region>.icr.io/user1/my_first_repo@<digest1>
  example-<region>.icr.io/user1/my_first_repo@<digest2>
  example-<region>.icr.io/user1/my_first_repo@<digest3>
  

• 次の ibmcloud cr image-list コマンドを実行すると、サイズが 1 MB を超えるタグが付いているすべてのイメージのリポジトリー、タグ、セキュリティーの状況を表示します。

  ibmcloud cr image-list --format "{{ if gt .Size 1000000 }}{{ .Repository }}:{{ .Tag }} {{ .SecurityStatus.Status }}{{end}}"
  

  以下のメッセージは、コマンドからの出力の例です。

  example-<region>.icr.io/user1/my_first_repo:latest No Issues
  example-<region>.icr.io/user1/my_second_repo:1 2 Issues
  example-<region>.icr.io/user1/my_second_repo:test1 1 Issue
  example-<region>.icr.io/user1/my_second_repo_2:test2 7 Issues
  

  リスト画像コマンドがタイムアウトした場合は 、「画像をリストアップするとタイムアウトする理由」 を参照してください。

• 次の ibmcloud cr image-inspect コマンドを実行すると、指定した IBM パブリック・イメージについての IBM のドキュメンテーションがホストされている場所が表示されます。

  ibmcloud cr image-inspect ibm_public_image --format "{{ .ContainerConfig.Labels }}"
  

  以下のメッセージは、コマンドからの出力の例です。

  map[doc.url:/docs/images/docker_image_ibm_public_image/ibm_public_image_starter.html]
  

• 次の ibmcloud cr image-inspect コマンドを実行すると、指定されたイメージについて公開されているポートが表示されます。

  ibmcloud cr image-inspect ibm_public_image --format "{{ .Config.ExposedPorts }}"
  

  以下のメッセージは、コマンドからの出力の例です。

  map[9080/tcp: 9443/tcp:]