public_git
/
tart
mirror of https://github.com/cirruslabs/tart.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
macOS and Linux VMs on Apple Silicon to use in CI and other automations
461 Commits 15 Branches 181 Tags 29 MiB
Swift 92.7%
Go 5%
Python 1.3%
Shell 0.9%
Go to file
Nikolay Edigaryev 1b81b12760
tart pull: try to re-use APFS blocks by cloning the base image (#864) 
* tart pull: try to re-use APFS blocks by cloning the base image

* Punch a hole when a zero chunk is detected

* Properly retrieve errno when hole punching operation fails

* tart pull: do not retry on RuntimeError

* Ensure that the holes we're about to punch are FS block size-aligned

* VMDirectory: remove unused static variables

* tart pull: log if we've found an image to deduplicate against

* Do not prematurely read contents from disk

* Only consider candidates with deduplicatedBytes more than 0

* APFS reuse UX/DX improvements (#870)

* Show how much deduplication happening

Improvement to the APFS deduplication logic which checks whether a disk image file `mayShareFileContent` with some other file, and then we put a custom attribute to track the deduplication since there is no way to get this information from APFS itself.

It's not 100% accurate but given that OCI cache is immutable the actual disk usage can only be lover than that.

* Use string attribute

* Update Sources/tart/URL+Prunable.swift

Co-authored-by: Nikolay Edigaryev <edigaryev@gmail.com>

* Added SizeOnDisk colume

---------

Co-authored-by: Nikolay Edigaryev <edigaryev@gmail.com>

---------

Co-authored-by: Fedor Korotkov <fedor.korotkov@gmail.com>
 		2024-07-25 15:33:15 +00:00
.ci Lowercase `tart.app` (#751) 2024-03-11 12:23:12 -04:00
.github Added Code Owners (#328) 2022-11-17 22:57:12 -05:00
Resources Added Figma as a user (#858) 2024-07-10 15:06:01 +00:00
Sources/tart tart pull: try to re-use APFS blocks by cloning the base image (#864) 2024-07-25 15:33:15 +00:00
Tests/TartTests tart push: support --concurrency command-line argument (#868) 2024-07-18 17:52:55 +04:00
benchmark Introduce Golang-based benchmarking utility (#769) 2024-03-27 18:45:01 +04:00
docs Jumping through the hoops: SSH jump host functionality in Orchard (#844) 2024-06-20 22:39:41 +00:00
integration-tests integration-tests: downgrade "requests" package to 2.31.0 (#829) 2024-05-21 13:35:33 +00:00
scripts Fancy Social Cards (#830) 2024-05-22 16:07:08 +04:00
.cirrus.yml Fixed GoReleaser 2.0.0 (#839) 2024-06-05 19:09:56 +04:00
.editorconfig Update dependencies and styles (#12) 2022-03-24 18:54:49 +03:00
.gitignore Fancy Social Cards (#830) 2024-05-22 16:07:08 +04:00
.goreleaser.yml Generate shell completions by calling tart.app executable (#775) 2024-04-03 01:22:52 +02:00
.swiftformat Reformat code idents and introduce the SwiftFormat linter (#339) 2022-11-29 15:56:13 +00:00
CONTRIBUTING.md Add CONTRIBUTING.md? (#575) 2023-08-03 13:10:34 -04:00
LICENSE Relicensed under Fair Source License (#415) 2023-02-28 12:22:25 -05:00
Package.resolved tart pull: try to re-use APFS blocks by cloning the base image (#864) 2024-07-25 15:33:15 +00:00
Package.swift tart pull: try to re-use APFS blocks by cloning the base image (#864) 2024-07-25 15:33:15 +00:00
README.md Added Figma as a user (#858) 2024-07-10 15:06:01 +00:00
gon.hcl Build x86 binary (#716) 2024-01-26 13:09:05 +00:00
mkdocs.yml Fancy Social Cards (#830) 2024-05-22 16:07:08 +04:00

README.md

Tart is a virtualization toolset to build, run and manage macOS and Linux virtual machines (VMs) on Apple Silicon. Built by CI engineers for your automation needs. Here are some highlights of Tart:

  • Tart uses Apple's own Virtualization.Framework for near-native performance.
  • Push/Pull virtual machines from any OCI-compatible container registry.
  • Use Tart Packer Plugin to automate VM creation.
  • Easily integrates with any CI system.

Tart powers Cirrus Runners service — a drop-in replacement for the standard GitHub-hosted runners, offering 2-3 times better performance for a fraction of the price.

Many companies are using Tart in their internal setups. Here are a few of them:

Note: If your company or project is using Tart please consider sharing with the community.

Usage

Try running a Tart VM on your Apple Silicon device running macOS 13.0 (Ventura) or later (will download a 25 GB image):

brew install cirruslabs/cli/tart
tart clone ghcr.io/cirruslabs/macos-sonoma-base:latest sonoma-base
tart run sonoma-base

Please check the official documentation for more information and/or feel free to use discussions for remaining questions.