ERROR: Get https://registry-1.docker.io/v2/: net/http: TLS handshake timeout in Docker

Gambaran Umum Error

Pesan kesalahan ini muncul ketika Docker tidak dapat terhubung ke registry Docker Hub, yang diperlukan untuk menarik (pull) gambar kontainer. Kesalahan ini menyatakan “TLS handshake timeout”, yang berarti bahwa proses negosiasi koneksi aman menggunakan TLS (Transport Layer Security) tidak berhasil dalam waktu yang ditentukan. Ini sering kali disebabkan oleh masalah jaringan, konfigurasi proxy yang salah, atau masalah dengan sertifikat SSL.

Penyebab Umum

Beberapa penyebab umum untuk kesalahan ini meliputi:
1. Koneksi Internet yang Lambat: Koneksi yang tidak stabil atau lambat dapat menyebabkan timeout saat mencoba untuk melakukan handshake TLS.
2. Pengaturan Proxy yang Salah: Jika Anda menggunakan koneksi melalui proxy, pengaturan yang tidak tepat dapat menghalangi akses ke registry Docker.
3. Masalah dengan Sertifikat SSL: Sertifikat yang tidak valid atau tidak cocok dapat menyebabkan kegagalan dalam proses handshake TLS.
4. Firewall atau Kebijakan Jaringan: Firewall yang ketat atau kebijakan jaringan dapat membatasi akses ke port yang diperlukan untuk koneksi TLS.
5. Konfigurasi Docker yang Tidak Tepat: Pengaturan yang salah dalam file konfigurasi Docker dapat menyebabkan masalah koneksi.

Metode Solusi

Metode 1: Restart Docker

Langkah pertama yang perlu dicoba adalah merestart layanan Docker. Ini dapat memperbaiki masalah sementara yang mungkin terjadi:
1. Buka terminal.
2. Masukkan perintah berikut untuk merestart Docker:
bash
sudo systemctl restart docker
3. Coba jalankan kembali perintah yang menyebabkan kesalahan.

Metode 2: Periksa Pengaturan Proxy

Jika Anda berada di jaringan yang menggunakan proxy, pastikan pengaturan proxy dalam konfigurasi Docker benar. Misalnya:
1. Edit file konfigurasi Docker, biasanya terletak di /etc/systemd/system/docker.service.d/http-proxy.conf atau pada lokasi yang sesuai untuk sistem Anda.
2. Tambahkan atau perbarui entri berikut:
ini
[Service]
Environment="HTTP_PROXY=http://proxy.example.com:8080"
Environment="HTTPS_PROXY=https://proxy.example.com:8080"
Environment="NO_PROXY=localhost,127.0.0.1"
3. Simpan perubahan dan restart Docker seperti yang dijelaskan di Metode 1.

Metode 3: Ubah Alamat Mirror Registry

Jika Anda mengalami masalah dengan registry Docker, mengubah alamat mirror registry dapat membantu:
1. Edit file konfigurasi Docker yang sesuai.
2. Tambahkan atau ubah entri registry-mirrors seperti berikut:
json
{
"registry-mirrors": [
"https://dockerhub.azk8s.cn"
]
}
3. Restart Docker setelah melakukan perubahan.

Metode 4: Aktifkan Debugging

Mengaktifkan mode debugging pada Docker dapat memberikan lebih banyak informasi tentang kesalahan yang terjadi:
1. Edit file konfigurasi Docker.
2. Tambahkan debug: true di bawah bagian docker-engine.
3. Restart Docker untuk menerapkan perubahan.

Metode 5: Periksa Sertifikat SSL

Pastikan bahwa sertifikat SSL yang digunakan oleh server Anda valid dan tidak ada masalah dengan konfigurasi SSL. Jika Anda menggunakan Nginx, pastikan sertifikat dan kunci didefinisikan dengan benar dalam konfigurasi virtual host:

ssl_certificate /etc/nginx/ssl/my-certs/myCert.pem;
ssl_certificate_key /etc/nginx/ssl/my-certs/myserver.key;

Tips Pencegahan

Untuk menghindari kesalahan seperti ini di masa mendatang, Anda dapat mengikuti beberapa langkah pencegahan:
– Pastikan koneksi internet Anda stabil dan cepat.
– Selalu periksa pengaturan proxy jika Anda bekerja di jaringan korporat.
– Lakukan pembaruan perangkat lunak secara rutin, termasuk Docker dan sistem operasi.
– Jika menggunakan sertifikat SSL, pastikan sertifikat tersebut selalu valid dan diperbarui.

Ringkasan

Kesalahan “ERROR: Get https://registry-1.docker.io/v2/: net/http: TLS handshake timeout in Docker” dapat disebabkan oleh berbagai faktor, mulai dari koneksi internet yang lambat hingga pengaturan proxy yang salah. Dengan mengikuti langkah-langkah solusi yang telah dibahas, Anda dapat memperbaiki kesalahan ini dan mencegahnya terjadi di masa depan. Pastikan untuk memeriksa konfigurasi jaringan dan pengaturan Docker Anda secara berkala untuk menjaga kinerja yang optimal.