API를 VPS에 배포하기

웹 개발에서 샘플 API를 사용하는 이유는 무엇일까요?

팀은 처음에 샘플 API를 갖는 것의 가치에 대해 설명합니다. HTML, JavaScript, 심지어 Blazor 와 같은 기술로 프런트엔드 애플리케이션을 개발할 때 매우 중요한 테스트 환경입니다. 백엔드 로직부터 호스팅 및 배포에 이르기까지 웹 개발의 모든 과정을 경험할 수 있습니다.

도메인 전략: 준비가 되었을 때만 구매하라

팀은 중요한 원칙 하나를 강조합니다. 새로운 앱 아이디어가 떠오르자마자 서둘러 도메인 이름을 구매하지 말라는 것입니다. 개발자를 꿈꾸는 많은 사람들이 제대로 작동하는 프로토타입도 없이 도메인, 호스팅 패키지, 이메일 서버 같은 기능에 과도한 비용을 지출합니다.

그보다는 프로그래밍 언어, 데이터 모델, API 로직에 먼저 집중하세요. 프로젝트가 어느 정도 완성되면 그때 도메인과 호스팅 계정을 확보하면 됩니다. 하지만 이 튜토리얼을 위해 Tim은 자신이 추천하는 신뢰할 수 있는 호스팅 제공업체인 Namecheap을 통해 thesampleapi.com 도메인을 미리 구매했습니다.

VPS 호스팅 제공업체 선택하기

팀은 이 프로젝트에 InterServer를 사용합니다. InterServer는 고성능 저비용 가상 사설 서버를 제공하는 신뢰할 수 있는 VPS 호스팅 업체입니다. Tim은 일반적으로 Azure(특히 Microsoft SQL Server 또는 Enterprise 규모 배포의 경우)를 사용하지만, 여기서는 유연성을 보여주기 위해 InterServer를 선택했습니다.

그는 VPS 호스팅 플랜의 장점에 대해 언급합니다.

• 공유 호스팅 플랜보다 더 많은 제어 권한 제공

• 동적 웹사이트에서 더 나은 성능을 제공합니다.

• SSD 저장 장치 및 확장 가능한 디스크 공간

• 선택적 DDoS 공격 방지 및 운영체제에 대한 전체 액세스 권한 제공

Linux VPS와 Windows Server 호스팅 옵션을 비교하는 개발자에게 Tim의 사용 사례는 두 환경 모두에서 작업하는 방법을 보여줍니다. 다만 이 예시에서는 Windows 기반 VPS를 사용합니다.

Plesk 제어판을 이용한 웹 호스팅 설정

Tim은 Plesk 제어판을 통해 호스팅 서비스를 설정하는 과정을 설명합니다. VPS 솔루션은 일반적으로 웹 서버를 구성하기 위한 루트 액세스 또는 제어판 액세스 권한을 제공합니다. 그는 thesampleapi.com 도메인을 설정하고 기본적인 웹 호스팅을 구성합니다.

이 단계에는 다음이 포함됩니다.

• DNS 호스팅 활성화

• 호스팅 디렉토리 생성

• VPS에서 공유 서버와 전용 서버 구조 이해하기

Tim은 VPS 사용자들이 하나의 서버 인스턴스에 여러 도메인을 호스팅하는 경우가 많다고 언급합니다. 이것이 바로 기본적인 공유 윈도우 호스팅과 비교했을 때 VPS의 강점입니다. VPS는 필요에 따라 확장 가능하며 높은 트래픽도 효율적으로 처리할 수 있습니다.

Namecheap을 통한 DNS 설정 업데이트

Tim은 도메인을 호스팅 제공업체에 연결하기 위해 Namecheap의 네임 서버(NS) 레코드를 InterServer의 DNS를 가리키도록 업데이트합니다. 이를 통해 도메인이 VPS IP 주소로 확인될 수 있습니다.

팀은 이 과정이 최대 48시간이 걸릴 수 있다고 말하지만, 그의 경험상 15분 이내에 완료되는 경우가 많다고 합니다. 이는 자신의 작업물이 실제로 적용되는 것을 보고 싶어하는 .NET 개발자들에게는 반가운 소식입니다.

SSL 인증서 설치

현대 웹 애플리케이션에서 보안은 타협할 수 없는 요소입니다. 팀은 무료 사이트 암호화 서비스를 제공하는 Let's Encrypt를 사용하여 SSL 인증서를 설정합니다. 그는 와일드카드 SSL 인증서를 사용하여 www.thesampleapi.com 및 api.thesampleapi.com과 같은 하위 도메인도 보호합니다.

이는 특히 민감한 데이터를 처리하는 ASP.NET Core API의 경우 매우 중요한 단계입니다. SSL 인증서는 클라이언트와 웹 서버 간의 통신을 암호화하며, 고성능의 안전한 웹사이트를 구축하는 데 필수적입니다.

Visual Studio를 이용한 게시

다음으로 Tim은 Visual Studio에서 ASP.NET Core API를 게시하는 방법을 시연합니다.

1. 프로젝트를 마우스 오른쪽 버튼으로 클릭 → 게시

2. 대상으로 폴더를 선택하세요

3. 릴리스 모드를 선택합니다.

4. 배포 유형을 프레임워크 종속으로 설정합니다(적절한 .NET 버전이 사전 설치된 환경의 경우).

.NET 이 설치되지 않은 Linux 호스팅 환경에 배포하는 경우 Tim은 자체 포함 배포로 전환할 것을 권장합니다. 이 패키지에는 필요한 .NET Core 런타임이 포함되어 원격 서버에서의 호환성을 보장합니다.

게시를 완료하면 호스팅 제공업체에 직접 업로드할 수 있는 파일 세트가 생성됩니다.

웹 서버에 파일 업로드

팀은 제어판의 파일 관리자를 사용하여 기본 파일을 삭제하고 게시된 폴더를 업로드합니다. 그는 자신의 컴퓨터에서 VPS 파일 시스템으로 콘텐츠를 직접 끌어다 놓습니다. 업로드가 완료되면 도메인 URL에 접속했을 때 기본적인 "Hello World" 메시지가 표시되어 앱이 정상적으로 작동하고 있음을 알 수 있습니다.

고급 사용자의 경우, 호스팅 서비스의 기능에 따라 GitHub Actions 또는 웹 개발 도구를 사용하여 배포를 자동화하는 것을 권장합니다.

API 엔드포인트 테스트

그런 다음 Tim은 C# API에 정의된 경로인 /courses로 이동합니다. JSON 데이터가 반환되므로 ASP.NET Core 앱이 올바르게 작동하고 있음을 증명합니다. 이는 백엔드 로직, 라우팅 및 미들웨어가 웹 서버에서 제대로 처리되고 있음을 확인시켜 줍니다.

Swagger UI 수정 (Scaler/V1)

많은 .NET 개발자들이 흔히 겪는 문제 중 하나는 API 문서화에 사용되는 Swagger UI가 개발 모드에서만 작동한다는 점입니다. Tim은 프로젝트의 구성 파일 때문에 프로덕션 환경에서 Swagger가 비활성화되어 있다는 것을 발견했습니다.

그는 OpenAPI 설정을 구성 파일에서 업데이트하여 실제 운영 환경에서도 사용할 수 있도록 합니다. 이는 실제 환경에서 디버깅 및 테스트에 필수적입니다.

루트를 Swagger UI로 리디렉션

Tim은 홈페이지에 "Hello World"를 표시하는 대신 API의 루트 엔드포인트에 리디렉션을 추가합니다. 지금 방문 중https://thesampleapi.com 사용자를 자동으로 /scaler/v1의 Swagger 문서로 리디렉션합니다. 이 작은 변경 사항은 사용성을 향상시키고 개발자가 API 사양에 빠르게 접근할 수 있도록 도와줍니다.

업데이트 후 재배포

새로운 변경 사항을 반영하기 위해 Tim은 게시-업로드 프로세스를 다시 수행합니다. 그는 VPS 파일 디렉토리를 비우고 새 빌드를 다시 업로드합니다. 그는 이 방법으로 인해 짧은 다운타임이 발생하지만 개발 단계에서는 허용 가능하다고 설명합니다.

트래픽이 많은 프로덕션 애플리케이션의 경우 Tim은 스테이징 슬롯 사용을 권장합니다. 이 기능은 Azure와 같은 고급 호스팅 플랜이나 플랫폼에서 찾아볼 수 있습니다. 이를 통해 다운타임 없이 원활한 배포가 가능합니다.

최종 검증 및 API 테스트

업데이트된 API가 배포됨에 따라 Tim은 다음과 같이 확인했습니다.

• SSL 인증서가 활성화되었습니다

• 엔드포인트는 올바른 데이터를 반환합니다.

• Swagger UI는 /scaler/v1에서 접속할 수 있습니다.

배포가 성공적으로 완료되었습니다. 이제 개발자는 Angular, React, Blazor 와 같은 프런트엔드는 물론 WPF 및 WinForms와 같은 데스크톱 앱에서도 이 실시간 API를 대상으로 테스트할 수 있습니다.

다음 단계는 무엇인가요?

팀은 개발자들이 다양한 프런트엔드와 함께 샘플 API를 사용해 볼 것을 권장하며 마무리합니다. 동적인 웹사이트를 구축하든, 통합 기능을 테스트하든, 기존 ASP나 Visual Basic을 실험하든, 이 배포된 API는 매우 유용한 자산입니다.

다음 주소에서 실시간 API에 접속할 수 있습니다.

• https://thesampleapi.com

• https://www.thesampleapi.com

요약

VPS에 API를 배포하는 것은 .NET Core, .NET Framework 또는 일반적인 웹 애플리케이션을 개발하는 모든 개발자에게 매우 유용한 학습 경험입니다. 팀 코리의 비디오는 도메인 설정부터 최종 배포에 이르는 전체 과정을 보여주며 실용적인 팁과 모범 사례를 제공합니다.

VPS 호스팅 플랜으로 이전을 고려 중이거나, 기존 웹 호스팅 업체의 숨겨진 수수료를 피하고 싶거나, 공유 호스팅을 넘어 다른 호스팅 방식을 시험해보고 싶다면 이 튜토리얼이 올바른 방향을 제시해 줄 것입니다.

API를 처음 출시하든 .NET 서비스 호스팅을 탐색하든, 이 가이드는 동적이고 확장 가능한 웹 앱을 구축하는 데 필요한 명확성, 제어 기능 및 강력한 기능을 제공합니다.