apple/container

container

는 Mac에서 가벼운 가상 머신 (Virtual Machines)으로서 Linux 컨테이너 (Containers)를 생성하고 실행하는 데 사용할 수 있는 도구입니다. 이 도구는 Swift로 작성되었으며, Apple silicon에 최적화되어 있습니다.

이 도구는 OCI 호환 컨테이너 이미지 (OCI-compatible container images)를 소비하고 생성하므로, 모든 표준 컨테이너 레지스트리 (Container registry)에서 이미지를 가져오고 실행할 수 있습니다. 빌드한 이미지를 해당 레지스트리에 푸시할 수도 있으며, 다른 모든 OCI 호환 애플리케이션에서 해당 이미지를 실행할 수 있습니다.

container

는 저수준 컨테이너, 이미지 및 프로세스 관리를 위해 Containerization Swift 패키지를 사용합니다.

container

를 실행하려면 Apple silicon이 탑재된 Mac이 필요합니다.

빌드하려면 BUILDING 문서를 참조하십시오.

container

는 이 릴리스의 가상화 (Virtualization) 및 네트워킹 (Networking)에 대한 새로운 기능과 개선 사항을 활용하므로 macOS 26에서 지원됩니다. 이전 버전의 macOS는 지원하지 않으며, container

유지 관리자는 일반적으로 macOS 26에서 재현할 수 없는 문제에 대해서는 대응하지 않습니다.

GitHub 릴리스 페이지에서 container

를 위한 최신 서명된 설치 패키지를 다운로드하십시오.

도구를 설치하려면 패키지 파일을 더블 클릭하고 안내를 따르십시오. 설치 프로그램이 /usr/local 아래에 설치된 파일을 배치할 수 있도록 권한을 부여하려면 요청 시 관리자 비밀번호를 입력하십시오.

다음 명령으로 시스템 서비스를 시작하십시오:

container system start

업그레이드와 다운그레이드 모두, 초기 설치 단계를 따라 서명된 설치 패키지를 수동으로 다운로드하여 설치하거나 update-container.sh 스크립트 (/usr/local/bin에 설치됨)를 사용할 수 있습니다.

업그레이드 또는 다운그레이드를 하는 경우, 기존의 container

를 반드시 중지해야 합니다:

container system stop

최신 릴리스로 업그레이드하려면 단순히 아래 명령을 실행하십시오:

/usr/local/bin/update-container.sh

다운그레이드하려면 기존의 container

를 제거해야 합니다 (-k 플래그는 사용자 데이터를 유지하고, -d는 데이터를 제거합니다):

/usr/local/bin/uninstall-container.sh -k
/usr/local/bin/update-container.sh -v 0.3.0

다음 명령으로 시스템 서비스를 시작하십시오:

container system start

시스템에서 container를 제거하려면 /usr/local/bin에 설치된 uninstall-container.sh 스크립트를 사용하십시오. 도구와 함께 사용자 데이터도 삭제하려면 다음을 실행하십시오:

/usr/local/bin/uninstall-container.sh -d

나중에 재설치할 경우를 대비하여 사용자 데이터를 유지하려면 다음을 실행하십시오:

/usr/local/bin/uninstall-container.sh -k

• 간단한 웹 서버 이미지를 빌드(Build), 실행(Run), 게시(Publish)하여 container 가이드 투어를 진행해 보세요.
• 다양한 container 기능의 사용법을 배워보세요.
• container에 대한 간략한 설명과 기술적 개요(Technical overview)를 읽어보세요.
• 전체 명령 참조(Command reference)를 찾아보세요.
• 본인의 개발 시스템에서 container를 직접 빌드하고 실행해 보세요.
• 프로젝트 API 문서(API documentation)를 확인하세요.

container에 대한 기여(Contributions)는 언제나 환영하며 권장됩니다. 자세한 내용은 메인 기여 가이드(Contributing guide)를 참조해 주세요.

container 프로젝트는 현재 활발히 개발 중입니다. Swift 패키지(Swift package)로 프로젝트를 사용하거나 container 도구를 사용하는 측면 모두에서, 안정성은 0.1.1에서 0.1.2 사이와 같은 패치 버전(Patch versions) 내에서만 보장됩니다. 1.0.0 버전이 출시될 때까지 마이너 버전(Minor version) 릴리스에는 중대한 변경 사항(Breaking changes)이 포함될 수 있습니다.