colima

Fitur

Dukungan untuk Intel dan Apple Silicon Mac, dan Linux

• Antarmuka CLI sederhana dengan default yang masuk akal
• Penerusan port otomatis
• Volume Mounts
• Beberapa contoh
• Dukungan untuk beberapa runtime container
  • Docker (dengan kubernet opsional)
  • Containerd (dengan kubernet opsional)
  • Incus (wadah dan mesin virtual)

Memulai

Instalasi

Colima tersedia di Homebrew, MacPorts, dan Nix. Periksa di sini untuk opsi instalasi lainnya.

 # Homebrew
brew install colima

# MacPorts
sudo port install colima

# Nix
nix-env -iA nixpkgs.colima

Atau tetap di tepi pendarahan (hanya homebrew)

 brew install --HEAD colima

Perbaikan

Jika meningkatkan dari V0.5.6 atau lebih rendah, diperlukan untuk memulai lagi dengan menghapus instance yang ada.

colima delete # delete existing instance
colima start

Penggunaan

Mulai Colima dengan default

 colima start

Untuk opsi penggunaan lebih lanjut

 colima --help
colima start --help

Atau gunakan file konfigurasi

 colima start --edit

Runtimes

Pada startup awal, Colima memulai dengan runtime yang ditentukan pengguna yang default ke Docker.

Buruh pelabuhan

Klien Docker diperlukan untuk runtime Docker. Diinstal dengan Brew brew install docker .

Anda dapat menggunakan klien docker di macOS setelah colima start tanpa pengaturan tambahan.

Containerd

colima start --runtime containerd Start dan Setup Containerd. Anda dapat menggunakan colima nerdctl untuk berinteraksi dengan containerD menggunakan nerdctl.

Disarankan untuk menjalankan colima nerdctl install untuk menginstal skrip nerdctl alias di $ path.

Kubernetes

Kubectl diperlukan untuk Kubernetes. Diinstal dengan brew install kubectl .

Untuk mengaktifkan Kubernetes, mulailah Colima dengan --kubernetes Flag.

 colima start --kubernetes

Berinteraksi dengan registri gambar

Untuk runtime Docker, gambar yang dibangun atau ditarik dengan Docker dapat diakses oleh Kubernetes.

Untuk runtime Containerd, gambar yang dibangun atau ditarik di k8s.io namespace dapat diakses oleh Kubernetes.

Incus

Membutuhkan v0.7.0

Klien Incus diperlukan untuk runtime incus. Dapat diinstal dengan brew install incus .

colima start --runtime incus dimulai dan pengaturan incus.

Anda dapat menggunakan klien incus di macOS setelah colima start tanpa pengaturan tambahan.

CATATAN: Menjalankan mesin virtual di Incus hanya didukung pada M3 atau perangkat silikon apel yang lebih baru.

Tidak ada

Membutuhkan v0.7.0

Colima juga dapat digunakan semata -mata sebagai manajer mesin virtual tanpa kepala dengan menentukan none runtime.

Menyesuaikan VM

VM default yang dibuat oleh Colima memiliki 2 CPU, memori 2GIB dan 100GIB penyimpanan.

VM dapat disesuaikan baik dengan memberikan bendera tambahan ke colima start . misalnya --cpu , --memory , --disk , --runtime . Atau dengan mengedit file konfigurasi dengan colima start --edit .

CATATAN : Ukuran disk tidak dapat diubah setelah VM dibuat. Dari V0.5.3, ukuran disk dapat ditingkatkan.

Contoh Kustomisasi

• Buat VM dengan 1CPU, memori 2Gib dan penyimpanan 10Gib.

   colima start --cpu 1 --memory 2 --disk 10
  

• Ubah memori VM ke 4CPU dan 8GIB yang ada.

   colima stop
  colima start --cpu 4 --memory 8
  

• Buat VM dengan emulasi Rosetta 2. Membutuhkan v0.5.3 dan macOS> = 13 (ventura) pada silikon apel.

   colima start --vm-type=vz --vz-rosetta
  

Tujuan proyek

Untuk memberikan container runtimes pada macOS dengan pengaturan minimal.

Ada apa dengan namanya?

Colima berarti wadah di Lima.

Karena Lima adalah alias mesin Linux. Dengan transitivitas, Colima juga dapat berarti wadah pada mesin Linux.

Dan logonya?

Logo ini disumbangkan oleh Daniel Hodvogner. Periksa masalah ini untuk lebih lanjut.

Pemecahan masalah dan FAQ

Periksa di sini untuk pertanyaan yang sering diajukan.

Masyarakat

• Diskusi GitHub
• Masalah GitHub
• Saluran #colima di CNCF Slack
  • Akun baru: https://slack.cncf.io/
  • Login: https://cloud-rative.slack.com/

Bantuan yang diinginkan

• Dokumentasi (Halaman Wiki)

Lisensi

Mit

Mensponsori proyek

Jika Anda (atau perusahaan Anda) mendapat manfaat dari proyek dan ingin mendukung kontributor, silakan mendukung proyek.