:image-syncer を使用したコンテナイメージの移行

イメージリポジトリ間のイメージの移行と同期は、Kubernetes クラスターのデータを移行するための基盤です。 docker pull と docker push コマンドを含むスクリプトを使用した従来のイメージ同期方法には次の制限があります。

• ディスクストレージに依存します。 同期中にイメージをローカルディスクに保存する必要があります。 したがって、ディスク領域が使い果たされないように、ローカルイメージを適時に消去する必要があります。 さらに、ローカルディスクにイメージを書き込むために余分な時間が必要です。 これらの制限により、従来の方法を使用して、実稼働シナリオで多数のイメージを移行することはできません。
• Docker デーモンに依存します。 Docker デーモンは、同時にプルまたはプッシュできるイメージの数を厳密に制限します。 その結果、従来の方法では、高い同時実行性でイメージを同期することができません。
• HTTP API に依存して、いくつかの機能を実施します。 Docker CLI のみを使用してイメージを同期することはできません。 そのため、複雑な同期スクリプトを作成する必要があります。

image-syncer は、複数のイメージを同時に移行または同期するためのシンプルで使いやすいツールです。 image-syncer を使用すると、コンテナレジストリ、Docker、Hub、Quay.io、Harbour など、Docker Registry V2 に基づいたほぼすべてのメインストリームイメージリポジトリサービスとの間で Docker イメージを同期することができます。 実稼働環境で TB レベルのイメージを移行できることが検証されています。 詳細については、『image-syncer』をご参照ください。

image-syncer には次の機能があります。

• 複数のソースイメージリポジトリから複数の宛先イメージリポジトリにイメージを同期します。
• Docker Registry V2 に基づく Docker イメージリポジトリサービスをサポートします。

  たとえば、image-syncer は Docker Hub、Quay.io、Container Registry、Harbor をサポートしています。

• イメージをローカルディスクに保存せずに、メモリとネットワークを介してのみイメージを同期します。 これにより、同期速度が向上します。
• 増分同期をサポートします。

  image-syncer は、ファイルを使用して、同期されたイメージに関する blob 情報を記録します。 この方法では、イメージは繰り返し同期されません。

• 同時同期をサポートします。

  設定ファイルで同時にプルまたはプッシュできるイメージの数を調整することができます。

• 失敗した同期タスクを自動的に再試行して、ネットワークのジッターによって引き起こされるほとんどのイメージ同期の問題を解決します。
• Docker デーモンなどのプログラムに依存しません。

image-syncer を使用するには、設定ファイルを準備すれば可能です。 例：

{
    "auth": {                   //認証情報フィールド 各オブジェクトには、レジストリにアクセスするためのユーザー名とパスワードが含まれています。
                                // 通常、image-syncer には、ソースレジストリ内のタグからイメージを取得したり、タグにアクセスしたりするためのアクセス権限が必要です。
                                // image-syncer には、宛先レジストリにイメージをプッシュしてリポジトリを作成するアクセス権限が必要です。 レジストリの認証情報が提供されない場合、image-syncer はデフォルトで匿名モードでレジストリにアクセスします。

        "quay.io": {            //レジストリの URLは、イメージ URL のレジストリの URL と同じである必要があります。
            "username": "xxx",               // 任意。 ユーザー名
            "password": "xxxxxxxxx",         // 任意。 パスワード
            "insecure": true                 // 任意。 レジストリが HTTP 経由でアクセスされるかどうかを指定します。 その場合、このパラメーターを true に設定します。 規定値: false このパラメーターをサポートするのは、V1.0.1以降のバージョンの image-syncer のみです。
        },
        "registry.cn-beijing.aliyuncs.com": {
            "username": "xxx",
            "password": "xxxxxxxxx"
        },
        "registry.hub.docker.com": {
            "username": "xxx",
            "password": "xxxxxxxxxx"
        }
    },
    "images": {
        // イメージ同期ルールを記述するフィールド。 各ルールはキーと値のペアであり、キーはソースリポジトリの URL を指定し、値は宛先リポジトリの URL を指定します。

        // 名前空間全体またはレジストリを 1 つのルールで同期することはできません。 最大 1 つのルールでリポジトリを同期することができます。

        // ソースリポジトリと宛先リポジトリの URL は registry/namespace/repository: tag の形式であり、これは docker pull または docker push コマンドで使用されるイメージ URL 形式に似ています。
        //ソースリポジトリのURLには、少なくともregistry / namespace / repositoryが含まれている必要があります。 宛先リポジトリの URL が空の文字列でない場合は、少なくともregistry / namespace / repositoryも含まれている必要があります。
        // ソースリポジトリの URL を空の文字列にすることはでき ません。 ソースリポジトリから複数の宛先リポジトリにイメージを同期するには、複数のルールを設定する必要があります。
        // 宛先リポジトリ名とタグは、ソースのものと異なる場合があります。 この場合、イメージ同期ルールは、ドッカープル、ドッカータグ、ドッカープッシュコマンドを順番に組み合わせたように機能します。
        "quay.io/coreos/kube-rbac-proxy": "quay.io/ruohe/kube-rbac-proxy",
        "xxxx":"xxxxx",
        "xxx/xxx/xx:tag1,tag2,tag3":"xxx/xxx/xx"
        // ソースリポジトリの URL にタグが含まれていない場合、ソースリポジトリ内のすべてのイメージは、元のタグを使用して宛先リポジトリに同期されます。 この場合、宛先リポジトリの URL にもタグを含めることはできません。
        // ソースリポジトリの URL にタグが 1 つしか含まれていない場合、ソースリポジトリ内のこのタグを持つイメージのみが宛先リポジトリに同期されます。 宛先リポジトリの URL にタグが含まれていない場合、同期されたイメージはデフォルトで元のタグを保持します。
        // ソースリポジトリの URL にコンマ (,) で区切られた複数のタグが含まれている場合 (a/b/c: 1,2,3 など) 、宛先リポジトリの URL にタグを含めることはできません。 同期されたイメージは、デフォルトで元のタグを保持します。

        // 宛先リポジトリの URL が空の文字列である場合、イメージはデフォルトレジストリのデフォルト名前空間にある同じ名前とタグを持つリポジトリに同期されます。 デフォルトレジストリと名前空間は、コマンドパラメーターまたは環境変数を使用して設定することができます。
    }     
}