1. Hugo 상품 소개

Hugo는 GO 언어로 만들어진 가장 인기있는 오픈 소스 정적 사이트 생성기 중 하나입니다. 정적 웹 페이지를 빠르게 만들고 쉽게 관리할 수 있습니다.

네이버 클라우드 플랫폼의 Hugo는 설치형 상품으로 제공하고 있으며, 최신 버전의 Hugo는 GO 언어 런타임을 VM 설치와 동시에 제공합니다.

2. Hugo 상품 이용하기

2.1 서버 생성

네이버 클라우드 플랫폼의 Hugo 서버 생성 과정은 아래와 같습니다.

  1. 콘솔 접속
  2. 이미지 선택
  3. 서버 설정
  4. 인증키 설정
  5. ACG 설정
  6. 서버 생성 확인

2.1.1 콘솔 접속

콘솔에 접속해서 All Product > Compute > Server 메뉴로 이동합니다.

① 서버를 생성하려면 서버 생성 버튼을 클릭합니다.

2.1.2 이미지 선택

목록에서 설치할 서버 이미지를 선택합니다.

1. 이미지타입: Application을 선택합니다.

2. Application 이미지타입: Hugo를 선택합니다

3. 다음 버튼을 클릭하면 서버 설정 화면으로 이동합니다.

2.1.3 서버 설정

스토리지 종류, 서버 타입, 요금제, Zone을 선택하고, 서버 이름을 입력합니다.

1. Zone 선택: 서버를 생성할 Zone을 선택합니다.

  • Hugo 서비스는 모든 리전(Region)에서 지원되고 있습니다.

2. 스토리지 종류: 부팅 스토리지로 사용할 스토리지 종류를 선택합니다.

3. 서버 타입: 원하는 서버 타입을 선택합니다.

  • 일부 서버 스펙은 부팅 디스크 타입에 따라 지원되지 않을 수 있습니다.

  • 사용 용량에 따라 서버 타입 중 하나를 선택하세요.

4. 요금제 선택: 요금제는 월 요금제 또는 시간 요금제 중 선택할 수 있습니다.

5. 서버 이름: 서버 이름을 입력합니다.

  • 고객이 서버를 구별하기 위한 명칭으로, 중복해서 사용할 수 없습니다.

6. 서버 설정 완료 후, 다음 버튼을 클릭합니다.

2.1.4 인증키 설정

보유하고 있는 인증키가 있는 경우 보유하고 있는 인증키 이용을 선택하고, 보유하고 있는 인증키가 없는 경우 새로운 인증키 생성을 선택합니다. 자세한 인증키 설정 방법은 아래의 절차대로 인증키를 생성 또는 이용합니다.

새로운 인증키 생성

1. 새로운 인증키 생성을 선택합니다.

2. 인증키 이름을 입력합니다.

3. 인증키 생성 및 저장 버튼을 클릭하여 로컬 PC에 인증키 파일을 저장합니다.

  • 새로운 인증키를 발급받습니다.

  • 저장 후 인증키는 고객의 PC 안전한 위치에 보관해 주십시오.

  • 인증키는 최초의 관리자 비밀번호를 가져올 때 이용됩니다.

4. 다음 버튼을 클릭합니다.

보유하고 있는 인증키 이용

  • 보유하고 있는 인증키 이용을 선택합니다.

2.1.5 ACG 설정

보유하고 있는 ACG를 이용하거나 또는 신규 ACG를 생성하여 방화벽을 설정할 수 있습니다. SSH 접속을 위한 포트 22번과 Hugo 서버를 위한 포트를 1개를 임의로 설정합니다. (예: 11313)

보유하고 있는 ACG를 이용하여 방화벽 설정

보유하고 있는 ACG를 이용하여 방화벽을 설정하는 방법은 다음과 같습니다.

1. ACG는 필수로 선택해야 하며, 기본으로 제공하는 ‘ncloud-default-acg’를 포함하여 보유하고 있는 ACG 중에서 하나를 선택합니다.

  • 보유하고 있는 ACG는 최대 5개까지 선택할 수 있습니다.

  • 필수로 ACG를 선택해야 다음 버튼이 활성화되어 설정을 진행할 수 있습니다.

2. 보유하고 있는 ACG 외에 신규 ACG를 생성하여 설정하고 싶다면, 신규 ACG 생성을 선택합니다.

3. 다음 버튼을 클릭합니다.

신규 ACG를 생성하여 방화벽 설정

새로운 ACG를 생성하여 방화벽을 설정하는 방법은 다음과 같습니다.

1. 신규 ACG 생성에서 ACG 생성 버튼을 클릭합니다.

2. ACG 이름을 입력합니다.

3. ACG 설정에서 프로토콜, 접근 소스, 허용 포트를 입력하고 생성합니다. SSH 접속을 위한 포트 22번과 Hugo 서버를 위한 포트를 1개(예: 11313)를 추가합니다.

  • 프로토콜 : TCP, UDP, ICMP에서 선택

  • 접근 소스 : IP 주소 또는 ACG명 입력

  • 허용 포트 : 단일 포트 또는 범위 지정

터미널 접속을 위해서는 접속하려는 서버의 ACG에 SSH 'TCP/22'에 대한 규칙을 설정해야 합니다.

규칙을 추가하려면 프로토콜, 접근 소스, 허용 포트를 기재하고 추가 버튼을 클릭합니다.

4. 서비스 포트가 모두 추가된 경우 생성 버튼을 클릭합니다.

2.1.6 최종 확인

생성한 서버의 설정한 내용을 최종 확인합니다.

1. 서버 이미지, 서버, 인증키, ACG가 정상적으로 설정되었는지 확인합니다.

2. 최종 확인 후에는 서버 생성 버튼을 클릭합니다.

  • 서버가 생성되기까지는 수 분에서 수십 분이 소요됩니다.

서버 목록에서 확인

생성한 서버를 서버 목록 리스트에서 확인이 가능합니다.

1. 생성한 서버가 목록에 표시됩니다.

2. 서버가 생성되고 Hugo 패키지가 설치 완료되어 서버 상태가 운영중이 될 때까지 대기합니다.

2.2 접속 환경 설정

2.2.1 공인 IP

Hugo 상품을 사용하려면 반드시 공인 IP 주소를 이용해서 접속해야 하며, 공인 IP 사용에 대한 요금이 별도로 부과됩니다.

1. Server > Public IP 메뉴를 선택합니다.

  • 신청한 공인 IP가 없다면 다음과 같은 문구가 표기됩니다.

    • "보유중인 공인 IP가 없습니다. 공인 IP 신청 버튼을 클릭하여 새로운 공인 IP를 할당받으세요."

    • 공인 IP 주소를 할당받으려면 공인 IP 신청 버튼을 클릭합니다.

2. 적용 서버 선택에서 공인 IP 주소를 할당할 Hugo 서버를 선택합니다.

3. 적용 서버 이름을 확인하고, 다음 버튼을 클릭합니다.

4. 공인 IP의 설정 조건을 확인하고, 생성 버튼을 클릭합니다.

2.2.2 포트 포워딩

터미널 프로그램(PuTTY 등)으로 서버에 접속하려면 포트 포워딩을 설정해야 합니다.

1. 좌측 메뉴에서 Server 메뉴를 선택합니다. 서버에 접속하려면 포트 포워딩 설정 버튼을 클릭합니다.

2. 포트 포워딩 설정 화면에서 외부 포트 번호를 설정합니다.

  • 외부 포트 번호의 입력 범위는 1024 ~ 65,534로 서버 접속을 위한 기능 외에 서비스 용도로 사용할 수 없습니다.

  • 내부 포트 번호는 22로 정해져 있습니다.

3. 추가 버튼을 클릭하면 설정 내역이 하단에 추가되며 수정 또는 삭제 버튼을 클릭하여 설정 내역을 수정 및 삭제할 수 있습니다.

4. 적용 버튼을 클릭하면, 설정한 외부 포트로 터미널 프로그램을 이용하여 SSH 접속을 할 수 있습니다.

2.2.3 ACG

ACG에 터미널 접속 SSH('TCP/22') 및 Hugo 서비스('TCP/UDP' 설정) 규칙을 추가합니다.
서버 생성 시 규칙을 이미 추가한 경우는 이 단계의 ACG 설정 작업을 수행할 필요가 없습니다.

ACG 생성

Server 메뉴에서 ACG 메뉴로 이동합니다.

1. +ACG 생성 버튼을 클릭합니다.

  • ACG 메뉴에서 기본 제공되는 'ncloud-default-acg'가 자동으로 생성되어 있습니다.

2. 생성할 ACG 이름 및 해당 내용을 입력합니다.

3. 설정이 완료되면, 생성 버튼을 클릭합니다.

ACG 설정

1. 생성한 ACG를 선택합니다.

2. 상단 ACG 설정 버튼을 클릭합니다.

3. ACG 규칙 설정에서 프로토콜, 접근 소스, 허용 포트를 입력하고 생성합니다.

  • 프로토콜 : TCP, UDP, ICMP에서 선택

  • 접근 소스 : IP 주소 또는 ACG명 입력

  • 허용 포트 : 단일 포트 또는 범위 지정

  • 터미널 접속을 위해서는 접속하려는 서버의 ACG에 SSH 'TCP/22'에 대한 규칙이 설정되어 있어야 합니다.

  • 규칙을 추가하려면 프로토콜, 접근 소스, 허용 포트를 기재하고 추가 버튼을 클릭합니다.

4. 설정이 완료되면 적용 버튼을 클릭합니다.

2.2.4 서버 관리자 비밀번호 확인

터미널 프로그램(PuTTY 등)으로 서버에 접속하려면 관리자 비밀번호를 알아야 합니다.

1. Server 메뉴에서 접속하려는 서버를 선택합니다.

2. 서버 관리 및 설정 변경에서 관리자 비밀번호 확인을 선택합니다.

3. Drop files here or click to upload 버튼을 클릭해 서버 생성 시 개인 PC에 저장한 인증키 파일(.pem)을 첨부합니다.

  • 서버 생성 시에 다운로드한 인증키 파일은 안전한 위치에 보관하시기 바랍니다.

4. 인증키 파일을 첨부한 후, 비밀번호 확인 버튼을 클릭하면 터미널 프로그램으로 최초 서버 접속 시 사용할 비밀번호를 얻을 수 있습니다.

  • 서버에 접속 후 관리자가 기억할 수 있는 비밀번호로 변경하여 사용하는 것을 권장합니다.

2.2.5 서버 접속 확인

터미널 프로그램(PuTTY 등)을 실행합니다.

1. 서버 리스트 또는 내용 보기에서 확인한 '서버 접속용 공인 IP'와 '외부 포트'의 값을 입력하고 Open 버튼을 클릭하면 서버에 접속됩니다.

  • 서버 접속용 공인 IP 확인 : 콘솔의 Server > Server 메뉴에서 서버 선택 후 상세정보에서 포트 포워딩 정보서버 접속용 공인 IP 값 확인

  • 외부 포트 번호 확인 : 콘솔의 Server > Server 메뉴에서 서버 선택 후 상세정보에서 포트 포워딩 정보외부 포트 값 확인

2. 사용자 정보 및 암호를 입력하고 로그인합니다.

  • Login as: root

  • Password : 위에서 확인한 관리자 비밀번호

3. 로그인 후에는 root 계정의 비밀번호를 기억할 수 있는 비밀번호로 변경할 것을 권장합니다. passwd root 명령어를 이용하여, 새로운 암호로 변경할 수 있습니다.

  • 단순한 조합의 간단한 비밀번호로 변경하면 해킹의 위험이 있습니다.

  • 비밀번호의 길이는 영문, 숫자, 특수문자를 합쳐서 최소 8자리 이상으로 설정할 것을 권장하며, 최근 사용한 비밀번호는 재사용하지 않는 것이 좋습니다.

    • 같은 영문 또는 숫자는 연속적으로 세번 이상 사용하지 않는 것이 좋습니다. (예: aaa, 111, bbb, qwe, asd, 123 등)

    • 네이버 클라우드 플랫폼에서 자동으로 생성된 초기 비밀번호는 보안적으로 안전한 형태의 비밀번호입니다.

3. Hugo 시작하기

네이버 클라우드 플랫폼 Hugo 서버 이미지를 생성하면 기본적으로 Hugo 소프트웨어가 설치됩니다. 설치된 소프트웨어의 디렉터리 구조는 아래와 같습니다.

/
|___ usr
       |___ local
                |___ go
|___ root
        |___ hugo
        |___ go
        |___ demosite

[각 폴더 구성 및 설명]

  • /usr/local/go

    • go 1.12.7 소스가 설치되어 있는 디렉터리 입니다. 자세한 설명은 이곳에서 확인할 수 있습니다.
    • GO와 관련된 환경변수는 cat ~/.bash_profile으로 확인할 수 있습니다.
  • /root/hugo

    • Hugo 프로젝트 소스가 위치한 디렉터리입니다. Hugo 프로젝트에 대한 자세한 설명은 이곳에서 확인할 수 있습니다.
    • 항상 최신 버전의 Hugo (Master 브랜치)가 설치됩니다.
  • /root/go

    • GOPATH로 설정되어 있는 디렉터리입니다.
    • 빌드된 Hugo의 실행파일이 go/src에 위치합니다.
    • Hugo 빌드하기 위한 디펜던시는 go/pkg/mod에 위치합니다.
  • /root/demosite

    • 상품 이용 시 기본으로 설치 및 적용되어 있는 Hugo 테마가 위치한 디렉터리입니다.
    • 해당 테마의 이름은 Hyde이며, 이곳에서 자세한 내용을 확인할 수 있습니다.

해당 Hugo 상품은 'Hyde' 테마를 제공하고 있으며, 기본적으로 제공하는 테마를 사용하거나 또는 사용자가 지정하여 테마를 설치하고 적용할 수 있습니다. 자세한 방법은 아래의 내용을 확인할 수 있습니다.

3.1 기본 제공 테마로 시작하기

해당 Hugo 상품 이용 시, 'Hyde' 테마가 기본으로 설치 및 적용되어 있습니다. 다음과 같이 명령어를 이용하여 Hugo 서버를 실행할 수 있습니다.

cd /root/demosite

hugo server -D -p {acg 설정한 포트} --bind 0.0.0.0 --baseURL http://{신청한 공인 IP} &

예를 들어, {acg 설정한 포트}11313이고, {신청한 공인 IP}123.123.123.123일 경우에는 아래와 같이 명령어를 구성하여 이용합니다.

hugo server -D -p 11313 --bind 0.0.0.0 --baseURL http://123.123.123.123 &

Hugo 서버를 실행한 후, 웹 브라우저에서 http://{신청한 공인 IP}:{acg 설정한 포트}로 접속하여 확인할 수 있습니다. 아래와 같은 예시로 사용 가능합니다.

http://123.123.123.123:11313

Hugo 서버 접속에 성공한 결과는 아래 이미지와 같습니다.

HUGO 서버 종료는 다음과 같이 실행할 수 있습니다.

fuser -k -TERM 11313/tcp

3.2 사용자 지정 테마로 시작하기

수백 가지가 넘는 Hugo 테마를 휴고 공식 사이트에서 확인할 수 있습니다.

  • 각 테마별로 제공하고 있는 Github Repository와 이용 방법이 다르게 제공하고 있기 때문에 해당 페이지에 방문하여 자세한 설치 및 이용 가이드를 참고하시기 바랍니다.

연관 정보 바로가기

Hugo 사용에 대한 자세한 설명은 다음 웹페이지를 확인하십시오.

""에 대한 건이 검색되었습니다.

    ""에 대한 검색 결과가 없습니다.

    처리중...