프로젝트 생성과 구조

템플릿을 선택해 만듭니다

웹 프로젝트도 콘솔과 같이 dotnet new 로 만듭니다. 다만 뒤에 적는 이름이 여럿입니다. 무엇을 만들 것이냐에 따라 미리 채워 주는 것이 다르기 때문입니다.

이 트랙은 web 과 webapi 를 주로 사용합니다. 어느 것으로 만들든 안에 들어 있는 파일의 종류는 거의 같습니다. 채워진 내용만 다릅니다. 어떤 것이 있는지 dotnet new list web 으로 볼 수 있습니다.

만들고 돌려 보기

webapi 로 하나 만들어 보겠습니다. 이 트랙이 끝날 때 만들 할일 API 와 이름을 맞춰 두었습니다.

dotnet new webapi -o TodoApi
cd TodoApi
dotnet run

이 단원의 명령은 브라우저가 아니라 여러분의 터미널에서 돌립니다.

찍힌 주소 뒤에 /weatherforecast 를 붙여 열면 템플릿이 넣어 둔 예제가 JSON 을 돌려줍니다. 포트 번호는 만들 때 무작위로 정해지므로 여러분의 것과 다릅니다.

[{"date":"2026-08-30","temperatureC":0,"summary":"Balmy","temperatureF":32}, …]

만들어진 파일

빌드하기 전의 폴더에는 파일이 여섯 개뿐입니다.

TodoApi/
├─ Program.cs                    // 프로그램이 시작하는 곳
├─ TodoApi.csproj                // 프로젝트 설정
├─ TodoApi.http                  // 편집기에서 요청을 보내 보는 파일
├─ appsettings.json              // 설정값
├─ appsettings.Development.json  // 개발일 때 덮어쓸 설정값
└─ Properties/
   └─ launchSettings.json        // dotnet run 이 읽는 실행 설정

dotnet run 을 하면 bin 과 obj 가 생깁니다. 빌드가 만드는 것이라 손대지 않고, 버전 관리에도 넣지 않습니다.

콘솔 프로젝트와 다른 곳

.csproj 의 첫 줄이 다릅니다. 콘솔은 Microsoft.NET.Sdk 인데 웹은 Microsoft.NET.Sdk.Web 입니다. 이 한 글자 차이로 ASP.NET Core 전체가 참조에 들어옵니다. 따로 패키지를 추가하지 않아도 WebApplication 을 사용할 수 있는 까닭입니다.

<Project Sdk="Microsoft.NET.Sdk.Web">

  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
  </PropertyGroup>

</Project>

launchSettings.json 은 개발 기계에서만 읽습니다

실행할 때 어느 주소로 띄울지는 여기에 있습니다. 그런데 이 파일은 배포본에 들어가지 않습니다. dotnet publish 한 폴더를 열어 보면 appsettings.json 은 있어도 launchSettings.json 은 없습니다. 개발하는 사람마다 다르게 두는 것이라 그렇습니다.

그래서 운영에서 주소를 정하는 방법은 따로입니다(5.1에서 다룹니다). 그리고 개발 중에는 반대로 이 파일이 --urls 나 ASPNETCORE_URLS 보다 앞섭니다. 주소를 바꿨는데 그대로라면 이 파일을 먼저 보십시오.

// 프로필 이름을 골라 띄웁니다
dotnet run --launch-profile http

// 프로필을 아예 사용하지 않습니다
dotnet run --no-launch-profile --urls http://localhost:5000

Program.cs 는 두 단계입니다

파일 하나뿐이지만 안이 둘로 나뉩니다. 경계는 builder.Build() 입니다.

var builder = WebApplication.CreateBuilder(args);

// ① 무엇을 갖출지 — 서비스를 등록합니다
builder.Services.AddOpenApi();

var app = builder.Build();

// ② 요청이 어떤 길로 지날지 — 미들웨어를 놓습니다
if (app.Environment.IsDevelopment()) {
    app.MapOpenApi();
}

app.UseHttpsRedirection();

app.MapGet("/weatherforecast", () => Results.Ok(forecast));

app.Run();

이 경계는 지켜야 합니다. Build() 는 그때까지 등록된 것으로 완성된 앱을 만들고, 서비스 목록을 읽기 전용으로 잠급니다. 뒤에서 추가하면 실행할 때 예외가 발생합니다.

var app = builder.Build();

builder.Services.AddSingleton<TimeProvider>(TimeProvider.System);

② 에 놓는 것들이 요청을 어떻게 지나보내는지는 ASP.NET Core 1.3 요청과 응답 파이프라인 에서 다룹니다.

Startup.cs 가 있는 예제를 만나면

직접 해보기