Skip to content

step-00.md

Latest commit

 

History

History
237 lines (160 loc) · 8.37 KB

step-00.md

File metadata and controls

237 lines (160 loc) · 8.37 KB

STEP 00: Setting Up the Development Environment

In this step, you will configure the development environment necessary for the workshop.

Prerequisites

Verify .NET SDK Installation

  1. Run the following command in the terminal to check if .NET SDK is installed.

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

    If you don’t see a path where dotnet can be executed, it means .NET SDK is not installed. If not installed, download the latest version from the .NET SDK installation page.

  2. Run the following command in the terminal to verify the installed .NET SDK version.

    dotnet --list-sdks

    The version should be 9.0.200 or higher. If it’s not, download the latest version from the .NET SDK installation page.

  3. Run the command below to install the local machine development HTTPS certificate.

    dotnet dev-certs https --trust

  4. Run the command below to update the .NET Aspire project template to the latest version.

    dotnet new install Aspire.ProjectTemplates --force

  5. Run the command below to update the .NET Aspire project library to the latest version.

    dotnet new update

Verify PowerShell Installation

  1. Run the following command in the terminal to check if PowerShell is installed.

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

    If you don’t see a path where pwsh can be executed, it means PowerShell is not installed. If not installed, download the latest version from the PowerShell installation page.

  2. Run the following command in the terminal to verify the installed PowerShell version.

    pwsh --version

    The version should be 7.5.0 or higher. If it’s not, download the latest version from the PowerShell installation page.

Verify git CLI Installation

  1. Run the following command in the terminal to check if git CLI is installed.

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

    If you don’t see a path where git can be executed, it means git CLI is not installed. If not installed, download the latest version from the git CLI installation page.

  2. Run the following command in the terminal to verify the installed git CLI version.

    git --version

    As of the time of writing this workshop documentation, the latest version is 2.39.5. If your version is older, download the latest version from the git CLI installation page.

Verify GitHub CLI Installation

  1. Run the following command in the terminal to check if GitHub CLI is installed.

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

    If you don’t see a path where gh can be executed, it means GitHub CLI is not installed. If not installed, download the latest version from the GitHub CLI installation page.

  2. Run the following command in the terminal to verify the installed GitHub CLI version.

    gh --version

    As of the time of writing this workshop documentation, the latest version is 2.68.1. If your version is older, download the latest version from the GitHub CLI installation page.

Verify Docker Desktop Installation

  1. Run the following command in the terminal to check if Docker Desktop is installed.

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

    If you don’t see a path where docker can be executed, it means Docker Desktop is not installed. If not installed, download the latest version from the Docker Desktop installation page.

  2. Run the following command in the terminal to verify the installed Docker Desktop version.

    docker --version

    As of the time of writing this workshop documentation, the latest version is 28.0.1. If your version is older, download the latest version from the Docker Desktop installation page.

Verify Visual Studio Code Installation

  1. Run the following command in the terminal to check if Visual Studio Code is installed.

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

    If you don’t see a path where code can be executed, it means Visual Studio Code is not installed. If not installed, download the latest version from the Visual Studio Code installation page.

  2. Run the following command in the terminal to verify the installed Visual Studio Code version.

    code --version

    As of the time of writing this workshop documentation, the latest version is 1.98.0. If your version is older, download the latest version from the Visual Studio Code installation page.

    If you can’t execute the code command, refer to this guide for configuration.

Launch Visual Studio Code

  1. Navigate to the directory where you will work.

  2. Run the following command in the terminal to fork this repository to your GitHub account and clone it to your computer.

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

  3. Run the following command in the terminal to navigate to the cloned directory.

    cd test-container-workshop

  4. Run the following command in the terminal to launch Visual Studio Code.

    code .

  5. Open the terminal in Visual Studio Code and run the following command to check the clone status of the current repository.

    git remote -v

    After running this command, you should see the following result. If you see devkimchi at origin, you need to clone the repository again from your account.

    origin  https://github.com/<Your GitHub ID>/test-container-workshop.git (fetch)
origin  https://github.com/<Your 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. In the Visual Studio Code terminal, run the following command to verify if the C# Dev Kit extension is installed.

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

    If you don’t see any message, it means the extension is not installed yet. Run the following command to install it.

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

Congratulations! You’ve completed the Setting Up the Development Environment exercise. Now, proceed to STEP 01: Create Dockerfile and Docker Compose Files.

Disclaimer:
This document has been translated using machine-based AI translation services. While we aim for accuracy, please note that automated translations may include errors or inaccuracies. The original document in its native language should be regarded as the authoritative source. For critical information, professional human translation is advised. We are not responsible for any misunderstandings or misinterpretations resulting from the use of this translation.