Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Artifact Registry meng-cache image Docker Hub publik yang sering diakses di
mirror.gcr.io. Anda dapat mengonfigurasi daemon Docker untuk menggunakan image publik
yang di-cache jika tersedia, atau mengambil image dari Docker Hub jika salinan yang di-cache
tidak tersedia.
Layanan
Google Cloud seperti Cloud Build dan Google Kubernetes Engine secara otomatis
memeriksa image yang di-cache sebelum mencoba mengambil image dari Docker Hub.
Layanan
Gambar yang di-cache di mirror.gcr.io adalah:
Disimpan dalam repositori yang dikelola oleh Google Cloud.
Lebih terisolasi dari pemadaman layanan Docker Hub.
Terintegrasi dengan ekosistem Google Cloud .
Tetap disinkronkan dengan Docker Hub.
Mengonfigurasi daemon Docker
Untuk mengonfigurasi daemon Docker agar mengambil image dari cache Artifact Registry:
CLI
Konfigurasikan daemon dengan salah satu cara berikut:
Untuk mengonfigurasi daemon Docker secara otomatis saat memulai, tetapkan
nilai berikut di /etc/docker/daemon.json
{"registry-mirrors":["https://mirror.gcr.io"]}
Saat Anda memulai daemon, teruskan nama host Artifact Registry:
dockerd--registry-mirror=https://mirror.gcr.io
Tambahkan baris berikut ke file /etc/default/docker Anda:
Artifact Registry menambahkan gambar yang sering diminta ke cache
sehingga tersedia untuk permintaan mendatang. Tindakan ini juga menghapus gambar secara berkala
yang tidak lagi diminta.
Setelah Anda mengonfigurasi daemon Docker untuk menggunakan cache Artifact Registry,
Docker akan melakukan langkah-langkah berikut saat Anda mengambil image Docker Hub publik
dengan perintah docker pull:
Daemon Docker memeriksa cache Artifact Registry dan mengambil
image jika ada. Jika konfigurasi daemon Anda menyertakan mirror Docker
lain, daemon akan memeriksa setiap mirror untuk mendapatkan salinan image yang di-cache.
Jika image masih tidak ditemukan, daemon Docker akan mengambil image dari
repositori kanonis di Docker Hub.
Mengambil image yang di-cache tidak akan mengurangi batas kapasitas Docker Hub. Namun,
tidak ada jaminan bahwa gambar tertentu akan tetap di-cache selama periode
waktu yang lama. Hanya dapatkan image yang di-cache di mirror.gcr.io dengan
mengonfigurasi daemon Docker.
Untuk melakukan autentikasi ke Docker Hub untuk image yang tidak di-cache di mirror.gcr.io,
gunakan repositori jarak jauh Artifact Registry. Repositori jarak jauh mendukung autentikasi ke Docker Hub. Sebaiknya autentikasi
ke Docker Hub meskipun Anda hanya menggunakan image publik, karena akan meningkatkan
batas kecepatan download. Untuk mengetahui informasi selengkapnya tentang batas kapasitas download Docker Hub,
lihat Batas kapasitas Docker Hub.
Langkah selanjutnya
Anda dapat membuat repositori jarak jauh Artifact Registry untuk meng-cache image Docker Hub.
Anda dapat membuat mirror Docker lokal Anda sendiri untuk meng-cache image. Untuk mengetahui detailnya, lihat dokumentasi Docker.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-08-18 UTC."],[[["\u003cp\u003eArtifact Registry caches frequently accessed public Docker Hub images on \u003ccode\u003emirror.gcr.io\u003c/code\u003e, allowing for faster access and increased insulation from Docker Hub outages.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Cloud services automatically prioritize checking for cached images on \u003ccode\u003emirror.gcr.io\u003c/code\u003e before pulling from Docker Hub.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure your Docker daemon to utilize the Artifact Registry cache by modifying the \u003ccode\u003e/etc/docker/daemon.json\u003c/code\u003e file, using the \u003ccode\u003edockerd\u003c/code\u003e command, modifying \u003ccode\u003e/etc/default/docker\u003c/code\u003e, or using the Docker UI.\u003c/p\u003e\n"],["\u003cp\u003eWhen pulling a public Docker Hub image after configuring the cache, the Docker daemon will first check the \u003ccode\u003emirror.gcr.io\u003c/code\u003e cache, then any other configured mirrors, and lastly, Docker Hub itself.\u003c/p\u003e\n"],["\u003cp\u003ePulling images from the Artifact Registry cache on \u003ccode\u003emirror.gcr.io\u003c/code\u003e does not count against Docker Hub rate limits, and you can use remote repositories for images not in the cache.\u003c/p\u003e\n"]]],[],null,["# Pull cached Docker Hub images\n\nArtifact Registry caches frequently-accessed public Docker Hub images on\n`mirror.gcr.io`. You can configure the Docker daemon to use a cached public\nimage if one is available, or pull the image from Docker Hub if a cached copy\nis unavailable.\nGoogle Cloud services such as Cloud Build and Google Kubernetes Engine automatically check for cached images before attempting to pull an image from Docker Hub.\n\nCached images at `mirror.gcr.io` are:\n\n- Stored in a repository managed by Google Cloud.\n- More insulated from Docker Hub outages.\n- Integrated with the Google Cloud ecosystem.\n- Kept in sync with Docker Hub.\n\nConfiguring the Docker daemon\n-----------------------------\n\nTo configure your Docker daemon to pull images from the Artifact Registry\ncache: \n\n### CLI\n\n1. Configure the daemon in one of the following ways:\n\n - To configure the Docker daemon automatically on startup, set\n the following value in `/etc/docker/daemon.json`\n\n {\n \"registry-mirrors\": [\"https://mirror.gcr.io\"]\n }\n\n - When you start the daemon, pass in the Artifact Registry\n hostname:\n\n dockerd --registry-mirror=https://mirror.gcr.io\n\n - Add the following line to your `/etc/default/docker` file:\n\n DOCKER_OPTS=\"${DOCKER_OPTS} --registry-mirror=https://mirror.gcr.io\"\n\n2. Restart the Docker daemon.\n\n - On Linux, run one of the following commands:\n\n sudo service docker restart\n\n or \n\n sudo service docker stop && sudo service docker start\n\n - On macOS or Windows, run the following command:\n\n docker-machine restart\n\n### Docker UI\n\n1. Open Docker's **Preferences** menu.\n2. Click **Daemon**.\n3. Click **Advanced** . In the JSON field, add a `registry-mirrors` key with\n `https://mirror.gcr.io` as a value:\n\n {\n \"registry-mirrors\" : [\n \"https://mirror.gcr.io\"\n ]\n }\n\n4. Click **Apply \\& Restart**.\n\nTo verify that the cache is correctly configured, run: \n\n docker system info\n\nThe output should include `Registry Mirrors`, and should look similar to\nthe following: \n\n Containers: 2\n Running: 0\n Paused: 0\n Stopped: 2\n Images: 2\n Server Version: 17.03.1-ce\n Storage Driver: overlay2\n Backing Filesystem: extfs\n Supports d_type: true\n Native Overlay Diff: true\n Logging Driver: json-file\n ...\n Registry Mirrors:\n https://mirror.gcr.io\n\nPulling cached images\n---------------------\n\nArtifact Registry adds frequently requested images to the cache\nso they are available for future requests. It also periodically removes images\nthat are no longer requested.\n\nAfter you configure the Docker daemon to use the Artifact Registry cache,\nDocker performs the following steps when you pull a public Docker Hub image\nwith a `docker pull` command:\n\n1. The Docker daemon checks the Artifact Registry cache and fetches the images if it exists. If your daemon configuration includes other Docker mirrors, the daemon checks each one in order for a cached copy of the image.\n2. If the image still isn't found, the Docker daemon fetches the image from the canonical repository on Docker Hub.\n\nPulling cached images does not count against Docker Hub rate limits. However,\nthere is no guarantee that a particular image will remain cached for an extended\nperiod of time. Only obtain cached images on `mirror.gcr.io` by\n[configuring the Docker daemon](#configure).\n\nTo authenticate to Docker Hub for images that aren't cached on `mirror.gcr.io`,\nuse Artifact Registry [remote repositories](/artifact-registry/docs/repositories/remote-overview). Remote\nrepositories support authentication to Docker Hub. We recommend authenticating\nto Docker Hub even if you are only using public images, as it will increase your\ndownload rate limit. For more information on Docker Hub download rate limits,\nsee [Docker Hub rate limit](https://docs.docker.com/docker-hub/download-rate-limit/).\n\nWhat's next\n-----------\n\n- You can create Artifact Registry [remote repositories](/artifact-registry/docs/repositories/remote-overview) to cache Docker Hub images.\n- You can create your own local Docker mirrors to cache images. For details, see the [Docker documentation](https://docs.docker.com/registry/recipes/mirror/).\n- Read the [Docker Hub documentation](https://docs.docker.com/docker-hub/)."]]