Format Referensi Docker Tidak Valid

Dalam tutorial ini, kita akan mempelajari apa arti kesalahan ini, mengapa itu terjadi, dan bagaimana Anda dapat mengatasinya dalam penggunaan Docker Anda.

Apa itu Referensi Gambar di Docker?

Di Docker, referensi gambar mengacu pada metode mengidentifikasi dan menemukan gambar Docker tertentu dalam registri Docker (Docker Hub) atau host Docker lokal.

Secara default, referensi gambar terdiri dari dua komponen utama:

Repositori – Bagian pertama mendefinisikan repositori untuk gambar target. Ini adalah unit organisasi tingkat atas untuk image Docker, terutama digunakan untuk mewakili organisasi atau individu yang mengelola image. Misalnya, Anda dapat menemukan gambar bernama Microsoft/SQL-server. Dalam hal ini, bagian pertama mewakili organisasi yang memelihara citra.

Tag – Bagian kedua dari gambar adalah label yang terkait dengan versi atau varian tertentu dari gambar dalam repositori. Tag gambar dapat mewakili versi berbeda dari gambar yang sama, rilis berbeda, atau kompatibilitas berbeda. Misalnya pada gambar nginx:latest dimana tag terbaru mengacu pada versi terbaru dari gambar Nginx.

Saat menentukan gambar dalam perintah Dockerfile atau docker, nama gambar harus mengikuti aturan penamaan berikut:

• Nama repositori harus menggunakan huruf kecil.
• Repositori juga dapat berisi huruf, angka, tanda hubung (-), garis bawah (_), atau garis miring (/) untuk menunjukkan organisasi atau pengelompokan dalam registri.
• Tidak boleh ada karakter spasi putih (spasi atau tab) di nama gambar.

Format Referensi Docker Tidak Valid

Jika Anda mendapatkan error “format referensi tidak valid” saat menjalankan perintah Dockerfile atau Docker, berarti nama Anda belum mematuhi aturan di atas.

Contohnya seperti pada gambar:

Jika kita menjalankan perintah di atas, maka akan muncul error seperti yang ditunjukkan:

tidak sah referensi format: nama repositori harus huruf kecil

Dalam hal ini, ini memberi tahu kita bahwa format nama gambar salah, karena nama gambar harus selalu menggunakan huruf kecil.

Cara Memperbaiki Kesalahan Format Referensi Tidak Valid Docker

Seperti yang bisa Anda tebak, cara pertama adalah memastikan format referensi gambar sudah benar. Ini termasuk memverifikasi bahwa nama gambar itu valid.

Misalnya, pada perintah di atas, kita dapat memperbaiki kesalahan dengan menentukan nama gambar sebagai:

Dalam hal ini, perintah harus menarik gambar Busybox versi terbaru.

Metode 2 – Pisahkan Perintah Docker yang Panjang

Dalam beberapa kasus lain, Anda mungkin mengalami kesalahan “format referensi tidak valid” saat menjalankan perintah Docker yang panjang.

Dalam kasus seperti ini, membagi perintah menjadi beberapa baris adalah praktik yang baik. Metode pemisahan perintah akan bergantung pada shell dan sistem Anda.

• Namun, untuk Bash shell, gunakan karakter escape multiline atau garis miring terbalik (\).
• Untuk PowerShell, Anda dapat menggunakan karakter backtick (`).
• Terakhir, jika Anda menggunakan Command Prompt, Anda dapat menggunakan karakter tanda sisipan sebagai ^

Misalnya, di Bash, jalankan perintah sebagai:

Di PowerShell, Anda dapat menjalankan perintah seperti yang ditunjukkan:

Dan terakhir, jika Anda berada di Command Prompt, gunakan perintah seperti yang ditunjukkan:

Metode 3 – jalur ${pwd} DAN $(pwd).

Penyebab umum lainnya dari kesalahan ini adalah saat menggunakan variabel ${pwd}. Hal ini dapat menyebabkan konflik, tergantung pada jenis shell tempat Anda menjalankan perintah tersebut.

Dalam kasus PowerShell, Anda perlu menggunakan variabel ${pwd} alih-alih $(pwd).

Seperti yang bisa Anda tebak, dalam kasus Bash, gunakan format tanda kurung alih-alih masukan kurung kurawal sebagai $(pwd).

Kesimpulan

Posting ini membahas penyebab utama “format referensi tidak valid” saat bekerja dengan perintah Dockerfile atau docker. Kami juga menjelajahi tiga metode utama yang dapat Anda gunakan untuk memperbaiki masalah ini.