Skip to content

Latest commit

 

History

History
228 lines (154 loc) · 8.56 KB

step-00.md

File metadata and controls

228 lines (154 loc) · 8.56 KB

STEP 00: 개발 환경 설정하기

이 단계에서는 워크샵 진행을 위해 필요한 개발 환경을 설정합니다.

사전 준비 사항

.NET SDK 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 .NET SDK를 설치했는지 확인합니다.

    # Bash/Zsh
which dotnet
    # PowerShell
Get-Command dotnet

    dotnet을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 .NET SDK 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 .NET SDK 버전을 확인합니다.

    dotnet --list-sdks

    9.0.100 이상의 버전이 보여야 합니다. 없을 경우 .NET SDK 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  3. 아래 명령어를 실행시켜 로컬머신 개발용 HTTPS 인증서를 설치합니다.

    dotnet dev-certs https --trust

  4. 아래 명령어를 실행시켜 .NET Aspire 프로젝트 템플릿을 최신으로 업데이트합니다.

    dotnet new install Aspire.ProjectTemplates --force

PowerShell 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 PowerShell을 설치했는지 확인합니다.

    # Bash/Zsh
which pwsh
    # PowerShell
Get-Command pwsh

    pwsh을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 PowerShell 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 PowerShell 버전을 확인합니다.

    pwsh --version

    7.4.0 이상의 버전이 보여야 합니다. 없을 경우 PowerShell 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

git CLI 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 git CLI를 설치했는지 확인합니다.

    # Bash/Zsh
which git
    # PowerShell
Get-Command git

    git을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 git CLI 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 git CLI 버전을 확인합니다.

    git --version

    워크샵 문서 작성 시점 기준 가장 최신 버전은 2.39.5입니다. 만약 버전이 낮다면 git CLI 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

GitHub CLI 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 GitHub CLI를 설치했는지 확인합니다.

    # Bash/Zsh
which gh
    # PowerShell
Get-Command gh

    gh을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 GitHub CLI 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 GitHub CLI 버전을 확인합니다.

    gh --version

    워크샵 문서 작성 시점 기준 가장 최신 버전은 2.62.0입니다. 만약 버전이 낮다면 GitHub CLI 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

Docker Desktop 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 Docker Desktop을 설치했는지 확인합니다.

    # Bash/Zsh
which docker
    # PowerShell
Get-Command docker

    docker을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 Docker Desktop 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 Docker Desktop 버전을 확인합니다.

    docker --version

    워크샵 문서 작성 시점 기준 가장 최신 버전은 27.3.1입니다. 만약 버전이 낮다면 Docker Desktop 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

Visual Studio Code 설치 확인

  1. 터미널에서 아래 명령어를 실행시켜 현재 Visual Studio Code를 설치했는지 확인합니다.

    # Bash/Zsh
which code
    # PowerShell
Get-Command code

    code을 실행시킬 수 있는 경로가 보이지 않는다면 설치하지 않은 것입니다. 만약 설치하지 않았다면 Visual Studio Code 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

  2. 터미널에서 아래 명령어를 실행시켜 현재 설치한 Visual Studio Code 버전을 확인합니다.

    code --version

    워크샵 문서 작성 시점 기준 가장 최신 버전은 1.95.3입니다. 만약 버전이 낮다면 Visual Studio Code 설치 페이지에서 최신 버전을 다운로드 받아 설치합니다.

    만약 터미널에서 code 명령어를 실행시킬 수 없다면, 이 문서를 참고하여 설정합니다.

Visual Studio Code 시작

  1. 작업할 디렉토리로 이동합니다.

  2. 터미널에서 아래 명령어를 실행시켜 이 리포지토리를 자신의 GitHub 계정으로 포크한 후 자신의 컴퓨터로 클론합니다.

    gh repo fork devkimchi/test-container-workshop --clone

  3. 터미널에서 아래 명령어를 실행시켜 클론한 디렉토리로 이동합니다.

    cd test-container-workshop

  4. 터미널에서 아래 명령어를 실행시켜 Visual Studio Code를 실행시힙니다.

    code .

  5. Visual Studio Code에서 터미널을 열고 아래 명령어를 실행시켜 현재 리포지토리의 클론 상태를 확인합니다.

    git remote -v

    이 명령어를 실행하면 아래와 같은 결과가 나와야 합니다. 만약 origin에 devkimchi가 보이면 자신의 리포지토리에서 다시 클론해야 합니다.

    origin  https://github.com/<자신의 GitHub ID>/test-container-workshop.git (fetch)
origin  https://github.com/<자신의 GitHub ID>/test-container-workshop.git (push)
upstream        https://github.com/devkimchi/test-container-workshop.git (fetch)
upstream        https://github.com/devkimchi/test-container-workshop.git (push)

  6. Visual Studio Code의 터미널에서 아래 명령어를 실행시켜 C# Dev Kit 익스텐션을 설치했는지 확인합니다.

    # Bash/Zsh
code --list-extensions | grep "ms-dotnettools.csdevkit"
    # PowerShell
code --list-extensions | Select-String "ms-dotnettools.csdevkit"

    만약 아무 메시지도 보이지 않는다면, 아직 설치하지 않은 것입니다. 아래 명령어를 실행시켜 설치합니다.

    code --install-extension "ms-dotnettools.csdevkit" --force

축하합니다! 개발 환경 설정하기 실습이 끝났습니다. 이제 STEP 01: Dockerfile 및 Docker Compose 파일 생성하기 단계로 넘어가세요.