이 가이드를 가장 잘 읽는 방법은 단계별로 따라가는 것입니다. 모든 단계는
예제 애플리케이션을 실행하는 데 필수적이며 추가 코드나 단계가
필요하지 않습니다.
이 가이드는 완전한 기능을 갖춘 개발 환경을 위한 development containers(줄여서 dev containers) 설정을 도와줍니다. Dev containers는 Ruby나 Rails 또는 의존성을 직접 기기에 설치할 필요 없이 container에서 Rails 애플리케이션을 실행하는 데 사용됩니다. 이것이 Rails 애플리케이션을 실행하는 가장 빠른 방법입니다.
이는 Getting Started 가이드에서 다루는 Ruby와 Rails를 기기에 직접 설치하는 것의 대안입니다. 이 가이드를 완료하면 Getting Started 가이드를 따라 애플리케이션을 계속 구축할 수 있습니다.
1 설정 및 설치
설정을 위해서는 Docker, VS Code 및
rails-new와 같은 관련 도구들을 설치해야 합니다. 각각에 대해 아래에서 자세히 살펴보겠습니다.
1.1 Docker 설치하기
Dev container는 애플리케이션을 개발, 배포, 실행하기 위한 오픈 플랫폼인 Docker를 사용하여 실행됩니다. Docker docs에서 운영체제별 설치 지침을 따라 Docker를 설치할 수 있습니다.
Docker가 설치되면, 컴퓨터에서 Docker 엔진을 실행하기 위해 Docker 애플리케이션을 실행하세요.
1.2 VS Code 설치하기
Visual Studio Code (VS Code)는 Microsoft가 개발한 오픈소스 코드 에디터입니다. VS Code의 Dev Containers 확장 프로그램을 사용하면 컨테이너 내부의(또는 마운트된) 모든 폴더를 열고 Visual Studio Code의 모든 기능을 활용할 수 있습니다. 프로젝트의 devcontainer.json 파일은 VS Code에게 잘 정의된 도구와 런타임 스택을 가진 개발 컨테이너에 어떻게 접근(또는 생성)할지 알려줍니다. 이를 통해 컨테이너를 빠르게 실행하고, 터미널 명령에 접근하고, 코드를 디버그하고, 확장 프로그램을 활용할 수 있습니다.
웹사이트에서 다운로드하여 VS Code를 설치할 수 있습니다.
마켓플레이스에서 다운로드하여 Dev Containers 확장 프로그램을 설치할 수 있습니다.
1.3 rails-new 설치하기
rails-new는 로컬 머신에 Ruby를 설치하지 않고도 새로운 Rails 애플리케이션을 생성할 수 있게 해줍니다. Docker를 사용해 Rails 애플리케이션을 생성하므로, 올바른 Ruby와 Rails 버전 설치는 Docker가 처리합니다.
rails-new를 설치하려면 README의 설치 안내를 따르세요.
2 블로그 애플리케이션 생성하기
Rails에는 generator라고 불리는 여러 스크립트가 함께 제공됩니다. 이는 특정 작업을 시작하는 데 필요한 모든 것을 생성해서 개발을 더 쉽게 만들도록 설계되었습니다. 그 중 하나가 새로운 애플리케이션 generator입니다. 이는 직접 작성할 필요 없이 새로운 Rails 애플리케이션의 기초를 제공합니다. rails-new 도구는 이 generator를 사용하여 새로운 Rails 애플리케이션을 생성합니다.
아래 예제들은 UNIX 계열 OS의 터미널 프롬프트를 나타내기 위해 $를 사용합니다. 실제로는 다르게 커스터마이즈되어 있을 수 있습니다.
rails-new를 사용해 앱을 생성하려면, 터미널을 열고 파일을 생성할 권한이 있는 디렉토리로 이동한 다음 실행하세요:
$ rails-new blog --devcontainer
이것은 blog 디렉토리에 Blog라는 이름의 Rails 애플리케이션을 생성할 것입니다.
rails new --help 명령어를 실행하면 Rails 애플리케이션 생성기가 받아들이는 모든 명령줄 옵션을 확인할 수 있습니다.
blog 애플리케이션을 생성한 후, 해당 폴더로 이동하세요:
$ cd blog
blog 디렉토리에는 Rails 애플리케이션의 구조를 구성하는 여러 생성된 파일과 폴더들이 있습니다. 이 튜토리얼의 대부분의 작업은 app 폴더에서 이루어질 것입니다. 애플리케이션의 모든 구성 요소에 대한 전체 설명은 Getting Started 가이드를 참조하세요.
3 Dev Container에서 Blog 애플리케이션 열기
새로운 Rails 애플리케이션에는 이미 구성되어 사용할 준비가 된 dev container가 포함되어 있습니다. VS Code를 사용하여 dev container를 실행하고 작업할 것입니다. VS Code를 실행하고 애플리케이션을 열면서 시작하세요.
애플리케이션이 열리면, VS Code는 dev container 구성 파일을 발견했다고 알려주며, 폴더를 dev container에서 다시 열 수 있다고 알려줄 것입니다. 초록색 "Reopen in Container" 버튼을 클릭하여 dev container를 생성하세요.
dev container 설정이 완료되면, Ruby, Rails 및 모든 의존성이 설치된 개발 환경을 사용할 준비가 된 것입니다.
VS Code 내의 터미널을 열어 Rails가 설치되었는지 확인할 수 있습니다:
$ rails --version
Rails 8.1.0
이제 Getting Started guide를 계속 진행하면서 Blog 애플리케이션을 구축하기 시작할 수 있습니다. 코드 실행, 테스트 실행, 애플리케이션 실행이 가능한 dev container의 진입점 역할을 하는 VS Code 내에서 작업하게 될 것입니다.