Visual Studio와 Git을 이용하여 Ubuntu에 ASP.NET Core Web App 배포하기

Visual Studio와 Git을 이용하여 Web App 배포하기

ASP.NET Core 개발환경으로는 Windows에서 Visual Studio를 사용하는 것이 가장 편합니다. 이번 포스팅에서는 Windows에서 ASP.NET Core Web App을 작성하여 Git을 이용하여 Ubuntu에서 실행하는 것을 소개해 드리겠습니다.

1. Github에 Repository 생성하기

본인의 GitHub 계정으로 가셔서 아래와 같이 원하는 이름으로 Repository를 생성합니다.

2. PC에 GitHub Repository Clone 하기

원하시는 폴더로 가셔서 GitHub Repository에 연결하세요. (아래에서 github 주소란에는 본인의 Repository 주소로 적어주세요.)

mkdir WebApp

cd WebApp

git init

git remote add origin https://github.com/DevStarSJ/WebApp.git

git pull origin master

3. Visual Studio로 Web App 예제 만들기

ASP.NET Core Web Application으로 프로젝트를 생성합니다. 위치를 좀 전에 Git Repository로 지정한 곳으로 해주세요.

다음 그림에서는 Web Application을 선택한 후에 OK를 눌러주세요.

제대로 만들어졌는지, F5를 눌러서 확인해봅니다.

4. GitHub에 올리기

git add --all

git commit -m "Initial Commit"

git push origin master

5. Ubuntu에서 내려받기

아직 git이 설치되어 있지 않다면 아래와 같이 설치를 해주세요.

sudo apt-get install git

이제 원하는 폴더로 가셔서 GitHub에서 내려받습니다. 위에 Windows에서 한것과 명령어가 같습니다.

mkdir WebApp

cd WebApp

git init

git remote add origin https://github.com/DevStarSJ/WebApp.git

git pull origin master

이제 WebApp 폴더로 들어가서 project.json의 framework부분을 아래와 같이 수정합니다.

cd WebApp/src/WebApp

  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        },
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
      },
      "imports": "dnxcore50"
    }
  },

저장한 뒤 이제 실행합니다.

dotnet restore

dotnet build

dotnet run

.NET Core Install for Ubuntu 14.04

.NET Core를 Ubuntu에 설치하는 과정에 대해서 소개해드리겠습니다.

Ubuntu 설치는 필자의 경우는 Microsoft Azure에 설치하였습니다. (참고로 Azure에 Ubuntu설치시 SSH (22)번 빼고는 모두 막혀있습니다. Portal에서 원하시는 포트를 열어야 합니다.)

1. .NET Core 설치 후 Hello World 출력해보기

먼저 .Net Core를 컴파일하고 실행할 수 있도록 SDK를 설치하겠습니다.

공식문서에 설명이 잘 되어 있습니다. (https://www.microsoft.com/net/core#ubuntu) 아래 설명대로 해서 잘 안되면 Link의 공식문서에 바뀐 점이 있는지 보시고 따라해주세요.

아래 명령어를 하나씩 입력해주세요.

sudo sh -c 'echo "deb [arch=amd64] https://apt-mo.trafficmanager.net/repos/dotnet/ trusty main" > /etc/apt/sources.list.d/dotnetdev.list'

sudo apt-key adv --keyserver apt-mo.trafficmanager.net --recv-keys 417A0893

sudo apt-get update

sudo apt-get install dotnet-dev-1.0.0-preview2-003121

이제 .Net Core SDK 설치가 끝났습니다. 제대로 설치가 되었는지 기본 예제를 실행해 보겠습니다.

mkdir hwapp

cd hwapp

dotnet new

dotnet restore

dotnet run

아래와 같이 출력이 나오면 제대로 설치가 된 것입니다.

2. ASP.NET Core 용 실행환경 구성

먼저 Web App 생성에 필요한 것들을 설치해야 합니다.

자세한 설명은 다음 Link에 되어 있습니다. (https://docs.asp.net/en/1.0.0-rc1/getting-started/installing-on-linux.html#installing-on-ubuntu-14-04)

2.1 .NET Version Manager (DNVM) 설치

Linux 상에서 여러 버전의 .NET 실행 환경 (.NET Execution Environment) DNX를 관리해주는 도구입니다.

sudo apt-get install unzip curl

curl -sSL https://raw.githubusercontent.com/aspnet/Home/dev/dnvminstall.sh | DNX_BRANCH=dev sh && source ~/.dnx/dnvm/dnvm.sh

2.2 .NET Execution Environment (DNX) 설치

Linux 상에서 .NET 프로젝트를 빌드하고 실행해주는 도구입니다.

sudo apt-get install libunwind8 gettext libssl-dev libcurl4-openssl-dev zlib1g libicu-dev uuid-dev

dnvm upgrade -r coreclr

2.3 libuv 설치

libuv는 멀티플랫폼 비동기 IO 라이브러리 입니다. Kestrel에서 libuv를 사용합니다. Kestrel은 ASP.NET Core를 호스팅하기 위한 크로스-플랫폼 HTTP 서버 입니다.

sudo apt-get install make automake libtool curl

curl -sSL https://github.com/libuv/libuv/archive/v1.8.0.tar.gz | sudo tar zxfv - -C /usr/local/src

cd /usr/local/src/libuv-1.8.0

sudo sh autogen.sh

sudo ./configure

sudo make

sudo make install

sudo rm -rf /usr/local/src/libuv-1.8.0 && cd ~/

sudo ldconfig

3. ASP.NET Core Web App 생성하기

다음 Link의 공식문서를 보고 작성하였습니다. (https://docs.asp.net/en/latest/getting-started.html)

좀 전에 생성한 예제 코드로 이동하겠습니다.

cd ~/hwapp

project.json의 dependencies란에 다음과 같이 Kestrel를 추가해주세요.

{
  "version": "1.0.0-*",
  "buildOptions": {
    "debugType": "portable",
    "emitEntryPoint": true
  },
  "dependencies": {},
  "frameworks": {
    "netcoreapp1.0": {
      "dependencies": {
        "Microsoft.NETCore.App": {
          "type": "platform",
          "version": "1.0.0"
        },
        "Microsoft.AspNetCore.Server.Kestrel": "1.0.0"
      },
      "imports": "dnxcore50"
    }
  }
}

패키지를 project에 다운로드 합니다.

dotnet restore

Startup.cs파일을 추가하려 다음의 내용으로 작성합니다.

using System;
using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;

namespace aspnetcoreapp
{
    public class Startup
    {
        public void Configure(IApplicationBuilder app)
        {
            app.Run(context =>
            {
                return context.Response.WriteAsync("Hello from ASP.NET Core!");
            });
        }
    }
}

Program.cs파일을 다음과 같이 수정해주세요.

using System;
using Microsoft.AspNetCore.Hosting;

namespace aspnetcoreapp
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseKestrel()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }
    }
}

그런 다음 실행합니다.

dotnet run

위 그림과 같은 메세지가 나오면 성공한 것입니다.

웹브라우저로 붙어보면 아래와 같은 그림이 나옵니다.

4. 외부에서 접속가능하게 배포하기

다음 Link의 공식문서를 보고 따라했습니다. (https://docs.asp.net/en/latest/publishing/linuxproduction.html)

Nginx를 설치합니다.

sudo apt-get install nginx

이제 우리가 띄운 Web App으로 접속하도록 Proxy를 설정합니다.

설정파일은 /etc/nginx/sites-available/default 입니다.

sudo vi /etc/nginx/sites-available/default

버전별로 내용이 조금 다룰수 있는데 눈여겨 볼 부분은 다음과 같습니다.

4.1 외부에서 접속할 Port 설정

아래 80부분을 원하는 Port로 설정하면 됩니다.

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

4.2 내부로 연결한 주소 설정

location부분을 아래와 같이 설정합니다.

location / {
    proxy_pass http://localhost:5000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection keep-alive;
    proxy_set_header Host $host;
    proxy_cache_bypass $http_upgrade;
}

중요한 부분만 그림으로 보면 다음과 같습니다.

수정한 내용에 이상은 없는지 확인한 후 실행합니다.

sudo nginx -t

sudo service nginx start

만약 수행 중 변경 후 반영하려면 다음과 같이 입력해야 합니다.

sudo nginx -s reload

이제 외부에서 Web App으로 접근이 가능합니다