서론

컨트롤러의 목적은 애플리케이션을 위한 특정 요청들을 받는 것이다. 클라이언트로부터 들어온 HTTP 요청들은 라우팅 메커니즘에 따라서 알맞은 컨트롤러로 분배된다.

Nest에서는 @Controller, @Get, @Post 등 데코레이터를 이용해서 컨트롤러를 구성할 수 있다.

nestcli를 이용해서 CRUD 컨트롤러를 간단히 만들 수 있다.

$ nest g resource [name]

Controller 데코레이터

import { Controller, Get } from '@nestjs/common';

@Controller('cats')
export class CatsController {
  @Get()
  findAll(): string {
    return 'This action returns all cats';
  }
}

@Controller, @Get 데코레이터를 사용하는 예제 코드

@Controller 데코레이터는 관계있는 라우터를 그룹화하는데 사용한다. 데코레이터의 인자로 라우팅 주소를 받는다. @Controller('cats')라고 작성하면 /cats 주소로 접근하는 모든 요청은 해당 컨트롤러를 거쳐갈 것이다.

Express.js로 따지자면 아래와 같이 만들 수 있다.

app.use('cats', CatsController);

@Get 데코레이터는 get메소드로 들어온 HTTP 요청을 받는 핸들러를 의미한다.

@Controller 데코레이터와 마찬가지로 인자로 라우팅 주소를 받는다. 인자로 아무 값도 넘기지 않으면 '/'로 연결된다.

즉, @Controller('cats') 내부의 @Get()는 /cats 경로로 GET 메소드 HTTP 요청이 들어오는 경우에 실행하는 핸들러가 된다.

만약 @Get('/profile') 애노테이션으로 라우터를 만든다면 /cats/profile 경로로 들어온 HTTP 요청을 처리할 것이다.

Response object

기본적으로 Nest 컨트롤러는 상태코드 200을 반환한다. Nest는 두 종류의 response 옵션을 제공하는데 아래와 같다.

• Standard (권장) 핸들러가 객체 또는 배열인 경우에 자동으로 이를 JSON으로 직렬화한다. 원시타입(string, number...)인 경우에는 직렬화하지 않고 보낸다. 상태코드는 항상 기본 200이다. (POST의 경우 201) 상태코드는 @HttpCode 데코레이터로 설정할 수 있다.

• Library-specific 특정 라이브러리의 response 객체를 의미함. (e.g. Express) 이러한 객체는 @Res 데코레이터를 사용해서 호출한다.

Nest에서도 @Res(), @Next() 등을 호출해서 사용할 수 있다. 이 데코레이터들을 호출하면 standard 옵션은 자동으로 비활성화 된다. 두 옵션을 동시에 사용하려면 @Res({ passthrough: true }) 이렇게 passthrough 옵션을 true로 설정하면 된다.

Request object

핸들러가 클라이언트의 request 객체에 접근할 일이 종종있다. Nest는 request 객체에 접근할 수 있는 @Req 데코레이터를 지원한다.

import { Controller, Get, Req } from '@nestjs/common';
import { Request } from 'express';

@Controller('cats')
export class CatsController {
  @Get()
  findAll(@Req() request: Request): string {
    return 'This action returns all cats';
  }
}

@Req 데코레이터 사용 예시

request 객체 전체가 아니라 클라이언트로부터 전달받은 body나 querystring만 필요한 경우에도 @Body, @Query 데코레이터를 위와 같이 호출하여 사용할 수 있다.

Resources

Nest는 모든 기본 HTTP 메소드를 데코레이터로 제공한다. 이 데코레이터들은 '@nestjs/common' 모듈에 선언되어 있다. @Get, @Post, @Put, @Delete, @Patch, @Options, @Head가 있으며 추가로 @All 데코레이터로 이 모든 메소드를 핸들링하는 라우터를 만들 수 있다.

import { Controller, Get, Post } from '@nestjs/common';

@Controller('cats')
export class CatsController {
  @Post()
  create(): string {
    return 'This action adds a new cat';
  }

  @Get()
  findAll(): string {
    return 'This action returns all cats';
  }
}

POST 메소드 라우팅 예시

Route wildcards

라우트 주소에 와일드카드 문자를 포함할 수 있다.

@Get('ab*cd')
findAll() {
  return 'This route uses a wildcard';
}

여기서 'ab*cd' 라우트 주소는 'abcd', 'ab_cd', 'abecd' 등과 매치된다. ?, +, *, (, ) 문자를 라우트 주소에 사용할 수 있고 정규표현식에서의 사용법을 일부 포함한다.

Asynchronicity

Nest는 async / await과 RxJS의 observable streams을 지원한다. async 함수는 반드시 Promise 타입을 반환한다.

// async 함수
@Get()
async findAll(): Promise<any[]> {
  return [];
}

// observable streams 사용
@Get()
findAll(): Observable<any[]> {
  return of([]);
}

Request payloads

위에서 살펴본 POST 메소드 예시 코드를 보면 핸들러가 클라이언트로부터 아무런 값도 받지 않고 있다.

@Body 애노테이션을 이용해서 클라이언트로부터 request body를 받아보자.

class CreateCatDto {
  name: string;
  age: number;
  breed: string;
}

@Post()
async create(@Body() createCatDto: CreateCatDto) {
  return 'This action adds a new cat';
}

ValidationPipe 기능을 사용해서 클라이언트로부터 받은 값들이 유효한지 검사할 수 있다.

import { Controller, Get, Query, Post, Body, Put, Param, Delete } from '@nestjs/common';
import { CreateCatDto, UpdateCatDto, ListAllEntities } from './dto';

@Controller('cats')
export class CatsController {
  @Post()
  create(@Body() createCatDto: CreateCatDto) {
    return 'This action adds a new cat';
  }

  @Get()
  findAll(@Query() query: ListAllEntities) {
    return `This action returns all cats (limit: ${query.limit} items)`;
  }

  @Get(':id')
  findOne(@Param('id') id: string) {
    return `This action returns a #${id} cat`;
  }

  @Put(':id')
  update(@Param('id') id: string, @Body() updateCatDto: UpdateCatDto) {
    return `This action updates a #${id} cat`;
  }

  @Delete(':id')
  remove(@Param('id') id: string) {
    return `This action removes a #${id} cat`;
  }
}

기본적인 CRUD 컨트롤러 구성

이렇게 만든 컨트롤러를 Nest가 인식할 수 있게 root module에 추가해주어야 한다.

import { Module } from '@nestjs/common';
import { CatsController } from './cats/cats.controller';

@Module({
  controllers: [CatsController],
})
export class AppModule {}

Nest.js 공식 문서 깃허브

Nest.js는 Node.js 서버사이드 애플리케이션을 만드는 프레임워크다. 타입스크립트를 완벽하게 지원하며, 오픈소스 프로젝트다.

기본적으로 Express를 이용해서 HTTP 통신을 하며 Fastify를 사용할 수도 있다.

공식 홈페이지에서는 두가지 설치 방법을 설명하고 있다.

$ npm i -g @nestjs/cli
$ nest new project-name

첫째는 @nestjs/cli 모듈을 사용하는 것이고,

$ git clone https://github.com/nestjs/typescript-starter.git project
$ cd project
$ npm install
$ npm run start

둘째는 스타터 프로젝트를 클론하여 사용하는 것이다.

위에 링크한 깃 저장소에 nest에서 공식으로 지원하는 여러 서버 애플리케이션 샘플을 참고할 수도 있다.

Nest.js는 기본적으로 컨트롤러 - 프로바이더 - 모듈 구조로 애플리케이션을 구성한다.

클라이언트로부터 HTTP 요청이 nest 서버에 들어오면 라우팅 메커니즘에 따라 알맞은 컨트롤러로 요청이 분배된다. 컨트롤러는 HTTP 요청을 받아서 메소드를 수행하고 결과를 클라이언트로 리턴한다.

import { Controller, Get } from '@nestjs/common';

@Controller('cats')
export class CatsController {
  @Get()
  findAll(): string {
    return 'This action returns all cats';
  }
}

공식 문서의 예제 코드를 보면 @nestjs/common 모듈으로부터 Controller와 Get 애노테이션을 임포트해서 Cats 컨트롤러 클래스를 만들고 있다.

@Controller('cats')는 '/cats' 경로에 요청이 오면 해당 컨트롤러를 참조하겠다는 뜻이 된다. 바로 아래에 @Get()는 '/cats' 경로에 Get 메서드로 요청이 오면 해당 함수를 실행하겠다는 뜻이 된다.

결과적으로 클라이언트가 'http://{domain}/cats' 에 Get 메서드로 요청을 보내면 클라이언트는 'This action returns all cats'라는 문자열을 서버로부터 리턴받을 것이다.

프로바이더는 Nest.js의 근본적인 개념으로, 수많은 Nest 기본 클래스들이 프로바이더로 취급된다. 프로바이더의 핵심은 --마치 자바 스프링처럼-- 의존성 주입(Dependency Injection)을 통해 관리한다는 것이다.

import { Injectable } from '@nestjs/common';
import { Cat } from './interfaces/cat.interface';

@Injectable()
export class CatsService {
  private readonly cats: Cat[] = [];

  create(cat: Cat) {
    this.cats.push(cat);
  }

  findAll(): Cat[] {
    return this.cats;
  }
}

다시 예제 코드다. 이번엔 CatsService라는 클래스를 만들었다. @Injectable 애노테이션을 임포트해서 사용하고 있는데, 이름 그대로 다른 클래스에서 의존성을 주입할 수 있게 해준다.

import { Controller, Get, Post, Body } from '@nestjs/common';
import { CreateCatDto } from './dto/create-cat.dto';
import { CatsService } from './cats.service';
import { Cat } from './interfaces/cat.interface';

@Controller('cats')
export class CatsController {
  constructor(private catsService: CatsService) {}

  @Post()
  async create(@Body() createCatDto: CreateCatDto) {
    this.catsService.create(createCatDto);
  }

  @Get()
  async findAll(): Promise<Cat[]> {
    return this.catsService.findAll();
  }
}

위에서 만든 프로바이더(CatsService)는 이렇게 컨트롤러에서 호출해서 사용할 수 있다.

마지막으로 모듈이다. 모듈은 컨트롤러와 마찬가지로 @Module 애노테이션을 임포트하여 사용한다. 모듈은 Nest가 애플리케이션의 계층 구조를 만들 수 있도록 메타데이터를 전달해준다.

Nest 애플리케이션은 기본적으로 root module이라고 하는 기본 모듈을 가진다. root module은 Nest가 각 모듈과 프로바이더의 관계성, 의존성을 확인할 수 있게하는 애플리케이션 그래프의 시작점이 된다.

import { Module } from '@nestjs/common';
import { CatsController } from './cats.controller';
import { CatsService } from './cats.service';

@Module({
  controllers: [CatsController],
  providers: [CatsService],
})
export class CatsModule {}

다시 예제 코드로 돌아와서, 앞서 만들었던 컨트롤러와 프로바이더를 포함하는 CatsModule을 만들었다.

import { Module } from '@nestjs/common';
import { CatsModule } from './cats/cats.module';

@Module({
  imports: [CatsModule],
})
export class AppModule {}

CatsModule은 다시 AppModule(root module)에서 임포트하여 Nest 애플리케이션에서 사용한다.

npm install --global으로 전역 모듈 설치 시 에러 발생.

/usr/lib/node_modules 디렉터리에 접근할 권한이 없어서 발생하는 에러.

sudo로 설치하면 설치가 잘 되지만 해당 모듈을 사용하려면 역시 sudo 권한이 필요함.

npm 공식 사이트에서는 npm 기본 경로를 변경할 것을 권장함.

그 방법은 링크에 자세히 설명되어 있음.

1. mkdir ~/.npm-global
2. npm config set prefix '~/.npm-global'
3. export PATH=~/.npm-global/bin:$PATH
4. source ~/.profile
5. npm install -g {module}

위와 같이 새로 생성한 .npm-global 디렉터리 하위에 전역 모듈이 설치됨.

node.js 클러스터는 기본적으로 윈도우즈를 제외하고 라운드로빈 방식으로 스케쥴링 한다.

윈도우즈에서는 기본적으로 OS가 직접 스케쥴링 하지만, libuv가 IOCP 처리를 오버헤드 없이 잘 분산할 수 있다면 라운드로빈으로 바뀐다.

CPU 코어 수만큼 워커를 생성하는 예

import cluster from 'cluster';
import { cpus } from 'os';
import http from 'http';

const numCPUs = cpus().length;

if (cluster.isPrimary) {
    for (let i = 0; i < numCPUs; i++) {
        cluster.fork();
    }
} else {
    http.createServer((req, res) => {
        res.writeHead(200);
        res.end('hello world\n');
    }).listen(8080);
}

마스터는 워커들을 관리해야 하기에 워커를 생성 및 관리하는 기능 등만 넣는 것이 좋다.

아래와 같이 스케쥴링 방식을 직접 변경할 수 있다.

// 라운드로빈 방식
cluster.schedulingPolicy = cluster.SCHED_RR

// OS가 직접 스케쥴링
cluster.schedulingPolicy = cluster.SCHED_NONE

워커는 fork한 만큼 생성되고, 다음과 같이 현재 스레드가 마스터인지 아닌지 확인할 수 있다.

let worker = cluster.fork();

if (cluster.isPrimary) {
    // primary
} else if (cluster.isWorker) {
  // none primary
}

cluster.isMaster 는 deprecate 되고 cluster.isPrimary에 통합되었다.

클러스터 이벤트 리스너를 아래처럼 사용할 수 있다.

// 워커가 죽으면 새로운 워커를 포크하는 함수
cluster.on('exit', (worker, code, signal) => {
    console.log('worker %d died (%s). restarting...',
        worker.process.pid, signal || code);
    cluster.fork();
});

클러스터 이벤트는 disconnect, exit, fork, listening, message, online, setup 등이 있다.

pm2의 클러스터 모드를 사용하면 클러스터 생명주기를 개발자가 직접 관리하지 않아도 된다. pm2 공식 문서에 따르면 클러스터 모드는 node.js의 클러스터 모듈을 사용해 구현했다고 한다.

참고

Node.js 공식문서 | Cluster

V8은 C++로 작성된 구글의 오픈소스 자바스크립트, 웹어셈블리 엔진이다. 구글 크롬과 Node.js에서 사용한다.

자바스크립트로 작성된 코드를 실행시간에 바이트코드로 컴파일하여 실행한다. → JIT 컴파일 방식

ECMA ES-262 표준에 맞추어 구현되어 있다.

내부적으로 몇가지 스레드를 사용한다.

• 코드를 가져오고, 컴파일하고 실행하는 메인 스레드
• 컴파일을 위한 스레드 → 코드를 최적화하는 동안 메인스레드가 계속 동작할 수 있도록 함
• 어떤 메소드를 실행할 때 시간이 많이 걸리는지 측정하는 프로파일러 스레드 → TurboFan으로 최적화
• 가비지 컬렉터 스윕을 관리하기 위한 스레드

인라인 캐싱, 히든 클래스 등 여러 최적화 기법을 사용하고 있다.

V8 엔진이 동작하는 과정

1. JS 코드를 파서에 전달
2. 파서에서 소스코드 분석 후 추상 구문 트리(AST)로 변환
3. AST를 Ignition에 전달 → JS를 바이트코드로 변환하는 인터프리터
4. 바이트코드 실행
5. 자주 사용되는 코드를 TurboFan에 전달 → 최적화 코드로 컴파일
6. 그중 자주 사용하지 않는 코드를 Deoptimize

v5.9부터 Full-codegen과 Crankshaft를 사용하지 않는다.

full-codegen, crankshaft 버리기 까지의 히스토리

V8 엔진의 컴파일러 파이프라인

Bytecode

고급 언어로 작성된 소스코드를 가상머신이 이해할 수 있는 중간 코드로 컴파일한 것

ignition의 바이트코드 파이프라인

참고

https://nodejs.dev/learn/the-v8-javascript-engine

https://evan-moon.github.io/2019/06/28/v8-analysis/

https://v8.dev/

https://github.com/v8/v8

https://blog.sessionstack.com/how-javascript-works-inside-the-v8-engine-5-tips-on-how-to-write-optimized-code-ac089e62b12e

ORM(Object-Relation Mapping)은 이름 그대로 객체와 관계형 데이터베이스를 연결해주는 기술으로, 쿼리를 객체지향 언어처럼 작성할 수 있게 해준다. Java의 Hibernate, Node.js의 Sequelize 등이 ORM 프레임워크이다.

var orm = require('generic-orm-library');
var user = orm("users").where({ email: 'test@test.com' });

가상의 ORM 라이브러리로 쿼리를 실행하는 예시.

자바스크립트뿐 아니라 다른 여러 언어에서 위와 같이 쿼리를 SQL이 아닌 익숙한 언어로 작성하여 사용할 수 있다.

ORM 사용의 장점

1. SQL 사용에 익숙하지 않더라도 쉽게 접근할 수 있다.
2. 특정 DBMS에 종속적이지 않아 데이터베이스 마이그레이션이 쉽다.
3. 트랜잭션, 커넥션풀 관리 등 여러 기능을 간편하게 사용할 수 있어 생산성이 높아진다.

ORM 사용의 단점

1. SQL을 직접 사용하는 것에 비해 성능이 떨어진다.
2. ORM 자체의 사용법을 배우는데 러닝커브가 있다.

TypeORM

타입스크립트와 자바스크립트 ES5~ES8에서 사용가능한 ORM 프레임워크로 Active Record와 Data Mapper 패턴을 모두 지원한다.

Active Record

모델 자체에 쿼리 메소드를 정의해서 모델의 메소드를 사용하여 객체를 조작하는 패턴.

import {BaseEntity, Entity, PrimaryGeneratedColumn, Column} from "typeorm";

@Entity()
export class User extends BaseEntity {

    @PrimaryGeneratedColumn()
    id: number;

    @Column()
    firstName: string;

    @Column()
    lastName: string;

    @Column()
    isActive: boolean;

    static findByName(firstName: string, lastName: string) {
        return this.createQueryBuilder("user")
            .where("user.firstName = :firstName", { firstName })
            .andWhere("user.lastName = :lastName", { lastName })
            .getMany();
    }

}

모델을 정의한 클래스에 스태틱 메소드형태로 쿼리를 작성해 객체를 조작한다.

Data Mapper

분리된 클래스에 쿼리 메소드를 정의하고 Repository를 이용하여 객체를 조작하는 패턴.

import {EntityRepository, Repository} from "typeorm";
import {User} from "../entity/User";

@EntityRepository()
export class UserRepository extends Repository<User> {

    findByName(firstName: string, lastName: string) {
        return this.createQueryBuilder("user")
            .where("user.firstName = :firstName", { firstName })
            .andWhere("user.lastName = :lastName", { lastName })
            .getMany();
    }

}

모델을 정의한 클래스와 분리하여 리포지토리 클래스를 만들어 리포지토리에서 객체를 조작한다.

공식 문서에 따르면 Data Mapper 패턴은 유지보수성이 좋고 대규모 앱에서 효과적으로 사용할 수 있다고 하며, Active Record 패턴은 구현이 간단하여 소규모 앱에서 사용하기 좋다고 한다.

참고

https://dev.solita.fi/2021/06/01/why-avoid-an-orm.html

https://axiomq.com/blog/comparing-orm-vs-sql-what-to-know/

https://blog.bitsrc.io/what-is-an-orm-and-why-you-should-use-it-b2b6f75f5e2a

https://www.freecodecamp.org/news/a-comparison-of-the-top-orms-for-2018-19c4feeaa5f/

https://typeorm.io/#/

• node.js의 내장 모듈
• 서버 생성과 커넥션 설정에 사용
• http를 통한 데이터 전송을 할 수 있음

Express

• node.js의 웹 애플리케이션 프레임워크 | 공식 사이트 링크
• 웹 서버 제작에 유용한 API, 서브모듈, 함수, 방법론, 컨벤션 등 제공 (e.g. 정적 호스팅, 템플릿, CSRF/CORS 설정, POST 데이터 핸들링, 미들웨어 등)

Callback 함수란 다른 함수의 매개변수로 넘겨준 함수를 의미함

자바스크립트에 콜백함수가 필요한 이유?

자바스크립트는 이벤트기반 (event-driven) 언어임

자바스크립트는 다음 명령어를 실행하기 전 이전 명령어의 응답을 기다리기보다 다른 이벤트를 기다리며 계속 명령을 수행함 (non-blocking)

A함수 이후에 B함수를 실행하고 싶은데 A함수의 작업이 즉시 끝나는 작업이 아니라면? (e.g. setTimeout())

function A() {
    setTimeout( function() {
        console.log(1);
    }, 1000);
}

function B() {
    console.log(2);
}

A();
B();

// output:
// 2
// 1

이런 코드가 있을 때 A를 B보다 먼저 호출하더라도 출력은 B가 먼저 나옴

이는 자바스크립트가 우리가 원하는 순서대로 함수를 실행하지 않은 것이 아니라 A() 함수의 실행 이후 끝을 기다리지 않고 바로 B() 함수를 실행하기 때문

즉 비동기 데이터를 처리하기 위해서 콜백함수가 필요함

콜백함수를 언제 어떻게 사용하는지?

위에서 살펴봤듯이 함수의 실행순서를 보장받고 싶을 때 콜백을 사용할 수 있음

한마디로 콜백함수는 함수의 실행이 종료될 때까지 다른 함수가 실행되지 않게 기다리는 것

function A(callback) {
    setTimeout(function() {
        console.log(1);
        callback();
    }, 1000);
}

function B() {
    console.log(2);
}

A(B);

// output:
// 1
// 2

B() 함수를 A() 함수의 매개변수로 넘겨서 A()의 콘솔 출력 이후 callback()을 호출할 수 있음

Winston

• 콘솔, 파일 등 다양한 출력형식을 지원하는 간단한 범용 로깅 라이브러리
• 아래와 같이 총 7가지 로그 레벨이 정의되어 있음

const levels = {
    error: 0,
    warn: 1,
    info: 2,
    http: 3,
    verbose: 4,
    debug: 5,
    silly: 6
};

사용예

• 아래 예시 코드처럼 직접 로거를 만들어 사용하는 것이 추천됨
• 아래는 에러와 일반 로그를 다른 파일로 분리하고 NODE_ENV 환경변수가 'production'이 아닐 때, 즉 개발/테스트 모드일 때는 콘솔에 출력을 하고 production 환경에서는 파일 출력만 하는 예제 코드

const winston = require('winston');

const logger = winston.createLogger({
  level: 'info',
  format: winston.format.json(),
  defaultMeta: { service: 'user-service' },
  transports: [
    //
    // - Write all logs with importance level of `error` or less to `error.log`
    // - Write all logs with importance level of `info` or less to `combined.log`
    //
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' }),
  ],
});

//
// If we're not in production then log to the `console` with the format:
// `${info.level}: ${info.message} JSON.stringify({ ...rest }) `
//
if (process.env.NODE_ENV !== 'production') {
  logger.add(new winston.transports.Console({
    format: winston.format.simple(),
  }));
}

winston-daily-rotate-file

• 로그 파일을 날짜, 크기제한 등에 따라 분리할 수 있게 하는 모듈

사용예

const logger = winston.createLogger({
  level: 'info',
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

//
// Replaces the previous transports with those in the
// new configuration wholesale.
//
const DailyRotateFile = require('winston-daily-rotate-file');
logger.configure({
  level: 'verbose',
  transports: [
    new DailyRotateFile(opts)
  ]
});

같은 타입의 다중 출력예

• info, error 레벨 로그를 각각 다른 파일로 출력

const logger = winston.createLogger({
  transports: [
    new winston.transports.File({
      filename: 'combined.log',
      level: 'info'
    }),
    new winston.transports.File({
      filename: 'errors.log',
      level: 'error'
    })
  ]
});

Morgan

• HTTP 리퀘스트 로깅 미들웨어

사용예

const morgan = require('morgan');

// Using a predefiend format string
morgan('tiny');

// Using format string of predefined tokens
morgan(':method :url :status :res[content-length] - :response-time ms');

// Using a custom format function
morgan(function (tokens, req, res) {
    return [
        tokens.method(req, res),
        tokens.url(req, res),
        tokens.status(req, res),
        tokens.res(req, res, 'content-length'), '-',
        tokens.['response-time'](req, res), 'ms'
    ].join(' ');
});

사전 정의된 포맷

• combined, common, dev, short, tiny 다섯 가지 포맷이 정의돼 있음

combined
:remote-addr - :remote-user [:date[clf]] ":method :url HTTP/:http-version" :status :res[content-length] ":referrer" ":user-agent"

common
:remote-addr - :remote-user [:date[clf]] ":method :url HTTP/:http-version" :status :res[content-length]

dev
:method :url :status :response-time ms - :res[content-length]

short
:remote-addr :remote-user :method :url HTTP/:http-version :status :res[content-length] - :response-time ms

tiny
:method :url :status :res[content-length] - :response-time ms

winston + morgan 함께 사용

• morgan 메소드의 두번째 인자에 winston logger를 넣으면 morgan에서 출력하는 로그가 winston으로 정의한 로거에 출력됨

const morgan = require('morgan');
const logger = require(WINSTON_LOGGER_LOCATION);

morgan('tiny', { logger });

새로운 토큰 생성

• morgan.token() 메소드를 호출해 새로운 토큰을 정의할 수 있음

morgan.token('type', function (req, res) { return req.headers['content-type'] });

pm2

Node.js 프로그램 백그라운드 실행 및 프로세스 관리를 도와주는 패키지.

설치 및 사용법

npm install pm2 --global

pm2 설치 명령어 (npm)

pm2 start app.js

프로세스 시작 명령어

• 스크립트를 직접 지정해서 시작하는 방법 외에도 별도로 콘피그 파일(.js)을 작성해 여러 옵션을 지정할 수 있음

pm2 kill [optional : process_name]

프로세스 종료 명령어

• 프로세스 지정하지 않으면 실행 중인 모든 프로세스 종료

pm2 log [optional : process_name]

로그 확인 명령어

• 프로세스 지정하지 않으면 모든 프로세스의 로그 출력

클러스터 모드

pm2의 클러스터 모드를 사용하면, 기본적으로 싱글 스레드에서 실행되는 Node.js 프로세스를 멀티 스레드로 실행할 수 있다.

pm2의 클러스터 모드는 내부적으로 Node.js ‘cluster’ 모듈을 사용해서 구현되어있다.

Cluster 모듈 레퍼런스 : Cluster | Node.js v16.13.0 Documentation

// pm2.config.js

module.exports = {
  apps: [
    {
      name: "server.account",
      script: "./dist/app.js",
      instances: 0,
      exec_mode: "cluster",

      ...

    }
  ]
};

위 예시처럼 exec_mode: “cluster”로 설정하면 클러스터 모드로 프로세스를 실행하게 된다. ‘instances’ 옵션을 설정하여 실행할 프로세스의 수를 정할 수 있고 0으로 설정하면 CPU 코어 수 만큼 (하이퍼스레딩을 지원한다면 코어 수의 2배) 프로세스를 실행한다.

pm2 start app.js -i max

혹은 위 명령어로 프로세스를 실행하는 방법도 있다. -i 옵션 뒤에 실행할 프로세스 수를 설정하여 사용한다.

pm2 scale app [원하는 프로세스 개수]

실행 중인 앱의 프로세스 수를 조절할 때는 scale 명령어를 사용하여 조절할 수 있다.

참고하면 좋은 포스팅

PM2를 활용한 Node.js 무중단 서비스하기 - LINE ENGINEERING

• 자바스크립트 1.6 기반 (ES5 및 1.7, 1.8 기능 일부 포함)
• 스프레드시트 등 구글 워크스페이스 태스크 자동화에 사용 가능

스프레드시트 기준 사용법

• 스프레드시트 → 도구 → 스크립트 편집기 클릭하면 앱스크립트 에디터 화면으로 이동함
• 함수 단위로 실행 / 디버그 가능
• 작성한 프로젝트를 배포하여 외부에서 호출 가능 (doGet, doPost 등 함수를 만들면 웹앱형태로 배포하여 GET, POST 방식으로 호출 가능함)

배포 (웹 앱)

1. 상단 배포 탭에서 새 배포 선택
2. 배포 유형 웹 앱 선택 후 설명을 작성한 뒤 배포
3. 배포 관리 탭에서 엔드포인트 확인 가능

통계

1. 좌측 네비게이터에서 개요 탭으로 들어가면 모든 배포에 대한 오류율, 실행 횟수 등을 확인할 수 있음

트리거 설정

1. 좌측 네비게이터에서 트리거 탭으로 들어가면 새 트리거(예약 실행 등)를 추가할 수 있음
2. 트리거 추가를 누르고 실행할 함수, 배포, 트리거의 종류 및 옵션을 선택하고 저장하면 트리거 설정 완료
3. 이후 설정된 트리거를 다음과 같이 확인 가능

라이브러리 문서

1. 앱스크립트는 자동으로 각 함수를 문서화하여 제공함
2. 배포 관리에서 확인하고 싶은 배포를 선택하고 라이브러리 주소로 브라우저에서 접근하면 간단한 문서 확인 가능

레퍼런스

• Reference overview | Apps Script | Google Developers

# 새 인덱스를 만들고 데이터 카피
PUT my_index_v1.0.1
{
  "mappings": {
    ...
  },
  "settings": {
    ... 
  }
}

POST _reindex
{
  "source": {
    "index": "my_index_v1.0.0"
  },
  "dest": {
    "index": "my_index_v1.0.1"
  }
}

# aliases 설정
POST _aliases
{
  "actions": [
    {
      "remove": {
        "alias": "my_index",
        "index": "my_index_v1.0.0"
      }
    },
    {
      "add": {
        "alias": "my_index",
        "index": "my_index_v1.0.1"
      }
    }
  ]
}

# 기존 인덱스 제거
DELETE my_index_v1.0.0

1. elasticsearch는 모든 인덱스를 수정 불가능한 세그먼트에 저장하고 각 세그먼트들은 실행 중에는 업데이트할 수 없음

2. 인덱스 별칭(aliases)을 설정하면 백그라운드에서 데이터를 다시 인덱싱할 수 있음

nori

• Elasticsearch 6.6 버전부터 공식 지원하는 한글 형태소 분석기

• mecab-ko-dic 사전 사용

설치

설치
$ bin/elasticsearch-plugin install analysis-nori

제거
$ bin/elasticsearch-plugin remove analysis-nori

인덱스 정의 예시

PUT nori_index
{
  "settings": {
    "analysis": {
      "analyzer": {
        "nori_discard": {
          "type": "custom",
          "tokenizer": "nori_t_discard",
          "filter": ["synonym", "my_shingle"]
        }
      },
      "tokenizer": {
        "nori_t_discard": {
          "type": "nori_tokenizer",
          "decompound_mode": "discard",
          "user_dictionary": "analysis/userdic.txt"
        }
      },
      "filter": {
        "synonym": {
          "type": "synonym_graph",
          "synonyms_path": "analysis/synonyms.txt"
        },
        "my_shingle": {
          "type": "shingle",
          "token_separator": "",
          "max_shingle_size": 3
        }
      }
    }
  },
  "mappings": {
    "properties": {
      "title": {
        "type": "text",
        "fields": {
          "nori": {
            "type": "text",
            "analyzer": "nori_discard"
          }
        }
      }
    }
  }
}

rooms 도큐먼트 검색 api

request example
GET nori_index/_search
{
  "query": {
    "match": {
      "title.nori": "동해"
    }
  }
}

response example
{
  "took" : 0,
  "timed_out" : false,
  "_shards" : {
    "total" : 1,
    "successful" : 1,
    "skipped" : 0,
    "failed" : 0
  },
  "hits" : {
    "total" : {
      "value" : 1,
      "relation" : "eq"
    },
    "max_score" : 2.3166962,
    "hits" : [
      {
        "_index" : "nori_index",
        "_type" : "_doc",
        "_id" : "iVF7_nwB93HRpra7cb9E",
        "_score" : 2.3166962,
        "_source" : {
          "title" : "동해물과 백두산이"
        }
      }
    ]
  }
}

nori_tokenizer

• 사전 정보를 이용해 형태소를 분리

• user_dictionary 옵션

사용자 사전이 저장된 파일 경로 입력 사전 내용 변경시 _close / _open 하여 인덱스에 변경사항 반영

• user_dictionary_rules

사용자 정의 사전을 배열 형태로 입력

• decompound_mode

합성어 저장 방식 결정 none : 완성된 합성어만 저장 discard (default) : 합성어를 분리하여 어근만 저장 mixed : 어근, 합성어 모두 저장

• nori_part_of_speech

제거할 품사를 지정하는 토큰 필터 옵션 stoptags 배열에 제외할 품사코드 나열해서 사용

• 품사코드

nori_readingform

• 한자 단어를 한글로 바꾸어 저장하는 토큰 필터

termvectors api

• 색인된 도큐먼트의 역인덱스를 확인할 때 사용하는 api

GET {index_name}/_termvectors/{document_id}?fields={fieldname}

request example
GET nori_index/_termvectors/jVHQ_nwB93HRpra7_L_M?fields=title.nori

response example
{
  "_index" : "nori_index",
  "_type" : "_doc",
  "_id" : "jVHQ_nwB93HRpra7_L_M",
  "_version" : 1,
  "found" : true,
  "took" : 4,
  "term_vectors" : {
    "title.nori" : {
      "field_statistics" : {
        "sum_doc_freq" : 102,
        "doc_count" : 8,
        "sum_ttf" : 102
      },
      "terms" : {
        "과" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 2,
              "start_offset" : 3,
              "end_offset" : 4
            }
          ]
        },
        "과백두" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 2,
              "start_offset" : 3,
              "end_offset" : 7
            }
          ]
        },
        "과백두산" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 2,
              "start_offset" : 3,
              "end_offset" : 8
            }
          ]
        },
        "동해" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 0,
              "start_offset" : 0,
              "end_offset" : 2
            }
          ]
        },
        "동해물" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 0,
              "start_offset" : 0,
              "end_offset" : 3
            }
          ]
        },
        "동해물과" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 0,
              "start_offset" : 0,
              "end_offset" : 4
            }
          ]
        },
        "물" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 1,
              "start_offset" : 2,
              "end_offset" : 3
            }
          ]
        },
        "물과" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 1,
              "start_offset" : 2,
              "end_offset" : 4
            }
          ]
        },
        "물과백두" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 1,
              "start_offset" : 2,
              "end_offset" : 7
            }
          ]
        },
        "백두" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 3,
              "start_offset" : 5,
              "end_offset" : 7
            }
          ]
        },
        "백두산" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 3,
              "start_offset" : 5,
              "end_offset" : 8
            }
          ]
        },
        "백두산이" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 3,
              "start_offset" : 5,
              "end_offset" : 9
            }
          ]
        },
        "산" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 4,
              "start_offset" : 7,
              "end_offset" : 8
            }
          ]
        },
        "산이" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 4,
              "start_offset" : 7,
              "end_offset" : 9
            }
          ]
        },
        "이" : {
          "term_freq" : 1,
          "tokens" : [
            {
              "position" : 5,
              "start_offset" : 8,
              "end_offset" : 9
            }
          ]
        }
      }
    }
  }
}

analyze api

• 형태소 분석 결과를 확인할 때 사용하는 api

request example
GET nori_index/_analyze
{
  "text": "동해물과 백두산이",
  "analyzer": "nori",
  "explain": true
}

response example
{
  "detail" : {
    "custom_analyzer" : false,
    "analyzer" : {
      "name" : "nori",
      "tokens" : [
        {
          "token" : "동해",
          "start_offset" : 0,
          "end_offset" : 2,
          "type" : "word",
          "position" : 0,
          "bytes" : "[eb 8f 99 ed 95 b4]",
          "leftPOS" : "NNP(Proper Noun)",
          "morphemes" : null,
          "posType" : "MORPHEME",
          "positionLength" : 1,
          "reading" : null,
          "rightPOS" : "NNP(Proper Noun)",
          "termFrequency" : 1
        },
        {
          "token" : "물",
          "start_offset" : 2,
          "end_offset" : 3,
          "type" : "word",
          "position" : 1,
          "bytes" : "[eb ac bc]",
          "leftPOS" : "NNG(General Noun)",
          "morphemes" : null,
          "posType" : "MORPHEME",
          "positionLength" : 1,
          "reading" : null,
          "rightPOS" : "NNG(General Noun)",
          "termFrequency" : 1
        },
        {
          "token" : "백두",
          "start_offset" : 5,
          "end_offset" : 7,
          "type" : "word",
          "position" : 3,
          "bytes" : "[eb b0 b1 eb 91 90]",
          "leftPOS" : "NNG(General Noun)",
          "morphemes" : null,
          "posType" : "MORPHEME",
          "positionLength" : 1,
          "reading" : null,
          "rightPOS" : "NNG(General Noun)",
          "termFrequency" : 1
        },
        {
          "token" : "산",
          "start_offset" : 7,
          "end_offset" : 8,
          "type" : "word",
          "position" : 4,
          "bytes" : "[ec 82 b0]",
          "leftPOS" : "NNG(General Noun)",
          "morphemes" : null,
          "posType" : "MORPHEME",
          "positionLength" : 1,
          "reading" : null,
          "rightPOS" : "NNG(General Noun)",
          "termFrequency" : 1
        }
      ]
    }
  }
}

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

위 에러가 발생하며 homebrew로 설치한 mysql에 접속이 안 될 때,

mysql --verbose --help | grep my.cnf

my.cnf 파일 위치를 찾아서 아래와 같이 수정해보자

# Default Homebrew MySQL server config
[mysqld]
# Only allow connections from localhost
bind-address = 0.0.0.0

"_moduleAliases": {
  "@src": "src" // 경로 및 이름은 알맞게 수정
}

tsconfig.json에 아래 구문 추가

"baseUrl": "./",
"paths": {
  "@src/*": [ "src/*" ] // 경로 및 이름은 알맞게 수정
}

npm 또는 yarn으로 아래 패키지 설치

npm i module-alias --save-dev
yarn add module-alias --save-dev

이후 상대경로 (../../src/file.ts) 사용하는 대신 alias (@src/file.ts) 로 import 가능

sudo apt update
sudo apt upgrade -y
sudo apt install apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"
sudo apt install docker-ce

도커 설치 이후 실행 확인

sudo service docker status

HTTP 헤더 설정을 자동으로 바꾸어 몇가지 잘 알려진 취약점으로 부터 앱을 보호할 수 있는 패키지

설치 방법

$ yarn add helmet @types/helmet
또는
$ npm install helmet @types/helmet

사용 예시

import helmet from 'helmet';

// 기본 11개 미들웨어 사용
app.use(helmet());

// helmet.frameguard를 제외한 기본 10개 미들웨어 사용
app.use(
  helmet({
    frameguard: false,
  })
);

기본으로 사용하는 미들웨어

• crossOriginEmbedderPolicy, crossOriginOpenerPolicy, crossOriginResourcePolicy, originAgentCluster 네가지를 제외한 11개 미들웨어를 기본으로 사용함

사용가능한 미들웨어

helmet.contentSecurityPolicy(options) : XSS(Cross site scripting) 공격 및 기타 교차 사이트 인젝션 예방

• Content Security Policy (CSP) - HTTP | MDN

helmet.crossOriginEmbedderPolicy() : Cross-Origin-Embedder-Policy 헤더를 require-corp로 설정

• Cross-Origin-Embedder-Policy - HTTP | MDN

helmet.crossOriginOpenerPolicy() : Cross-Origin-Opener-Policy 헤더를 설정

• Cross-Origin-Opener-Policy - HTTP | MDN

helmet.crossOriginResourcePolicy() : Cross-Origin-Resource-Policy 헤더를 설정

• Consider deploying Cross-Origin Resource Policy.
• Cross-Origin-Resource-Policy - HTTP | MDN

helmet.expectCt(options) : Expect-CT 헤더를 설정하여 SSL 인증서 오발급을 예방

• Certificate Transparency - Web security | MDN
• Expect-CT - HTTP | MDN

helmet.referrerPolicy(options) : Referrer-Policy 헤더를 설정하여 민감한 정보 유출 예방

• Referer - HTTP | MDN
• Referer header: privacy and security concerns - Web security | MDN
• Referrer-Policy - HTTP | MDN

helmet.hsts(options) : Strict-Transport-Security 헤더를 설정하여 보안연결(HTTPS) 강제

• Strict-Transport-Security - HTTP | MDN

helmet.noSniff() : X-Content-Type-Options 헤더를 nosniff로 설정하여 MIME 스니핑 예방

• MIME types (IANA media types) - HTTP | MDN
• X-Content-Type-Options - HTTP | MDN

helmet.originAgentCluster() : Origin-Agent-Cluster 헤더를 설정하여 오리진간 문서를 별도 에이전트 클러스터로 분리

• HTML Standard

helmet.dnsPrefetchControl(options) : X-DNS-Prefetch-Control 헤더를 설정하여 DNS 프리패칭을 조절

• X-DNS-Prefetch-Control - HTTP | MDN

helmet.ieNoOpen() : X-Download-Options 헤더를 설정하여 ie8 이상에서만 사용할 수 있도록 함

• IE8 Security Part V: Comprehensive Protection

helmet.frameguard(options) : X-Frame-Options 헤더를 설정하여 clickjacking 공격을 예방

• Clickjacking
• CSP: frame-ancestors - HTTP | MDN
• X-Frame-Options - HTTP | MDN

helmet.permittedCrossDomainPolicies(options) : X-Permitted-Cross-Domain-Policies 헤더를 설정하여 크로스도메인 컨텐츠 정책을 설정

• OWASP Secure Headers Project

helmet.hidePoweredBy() : X-Powered-By 헤더를 제거하여 웹앱의 프레임워크를 특정할 수 없도록 함

• Security improvement: don't reveal powered-by by madarche · Pull Request #2813 · expressjs/express

helmet.xssFilter() : X-XSS-Protection 헤더를 0으로 설정하여 크로스사이트 스크립트를 이용한 공격을 예방

• X-XSS-Protection: header should be disabled by default · Issue #230 · helmetjs/helmet
• X-XSS-Protection - HTTP | MDN

설치 (MacOS)

$ brew install k6

사용법

• 스크립트 작성

// script.js
import http from 'k6/http';
import { sleep } from 'k6';

export default function() {
  http.get(URI HERE); // get request to input URI
  sleep(1); // sleep while a second
}

• 쉘 명령어 입력

$ k6 run --vus 10 --duration 30s --out json=out.json script.js

vus: 동시 작업자 수

duration: 부하 테스트 시간

out: 출력 포맷 및 파일명

script.js: 실행할 스크립트

• POST 요청 등을 할 때 request body를 사용하기 위해서 json body를 문자열으로 변환하고 헤더를 추가해야함

import http from 'k6/http';
import { sleep, check } from 'k6';
import { uuidv4 } from "https://jslib.k6.io/k6-utils/1.1.0/index.js";


export default function () {
  const body = { deviceId: `${uuidv4()}` };
  const params = { headers: {'Content-Type': 'application/json'} };
  const res = http.post('https://api.avatarstudio.me/app/v1/session/guest', JSON.stringify(body), params);

  check(res, {
    'response code was 200': (res) => JSON.parse(res.body).errorCode === 200,
  });

  sleep(0);
}

실제 테스트 화면 캡처

• 동시 작업자 100개로 5초간 부하테스트한 결과 화면

check 함수

api 레퍼런스: https://k6.io/docs/javascript-api/k6/check-val-sets-tags/

요청의 결과값이 적절한지 확인하는 함수

import http from 'k6/http';
import { check } from 'k6';

export default function () {
  let res = http.get('http://httpbin.org');
  check(res, {
    'response code was 200': (res) => res.status == 200,
    'body size was 1234 bytes': (res) => res.body.length == 1234,
  });
}

위 코드와 같이 작성하여 결과값이 적절한지 검사 (response body가 JSON 오브젝트가 아니라 문자열 형태로 올 수 있으므로 그런 경우에는 JSON.parse() 함수를 사용하여 파싱해야 결과 비교를 제대로 할 수 있음)

uuidv4 함수

api 레퍼런스: https://k6.io/docs/javascript-api/jslib/utils/uuidv4/

무작위 uuid를 생성하는 함수

import { uuidv4 } from "https://jslib.k6.io/k6-utils/1.1.0/index.js";

export default function() {
  let randomUUID = uuidv4();
  console.log(randomUUID); // 35acae14-f7cb-468a-9866-1fc45713149a
}

k6 스크립트를 작성할 때는 미리 정의된 함수만 사용할 수 있음

API 호출에 uuid 값 등이 필요한 경우 위와 같이 미리 정의된 함수를 사용하여 필요한 값을 얻을 수 있음

간결한 문법

Class를 배제하여 복잡한 객체지향적 개념을 줄였으며 루프문은 for문 하나뿐이다. 단 25개 키워드만 사용하고 파이썬처럼 슬라이스 타입도 사용할 수 있다.

break, default, func, interface, select, case, defer, go, map,
struct, chan, else, goto, package, switch, const, fallthrough,
if, range, type, continue, for, import, return, var

손쉬운 패키지 관리

자바의 Maven, 자바스크립트의 NPM, 그 외 여러 언어와는 달리 패키지를 레지스트리에 등록하지 않고 깃에 코드를 올리기만 해도 프로그램에 포함하여 사용할 수 있다.

별도의 패키지 매니저를 사용하지 않고 go get 명령어만으로 패키지를 다운로드 받을 수 있다.

$ go get github.com/golang/protobuf

고루틴(코루틴)을 사용한 동시성 제어

고루틴은 OS 스레드보다 가벼운 경량 스레드다. 함수를 호출할 때 go 키워드를 붙이기만 하면 해당 함수를 고루틴으로 동작시킬 수 있다. 고루틴은 OS 스레드와 N:M 매핑되어 OS에서 조율하여 병렬실행을 처리해준다.

가비지 컬렉션과 제네릭 타입

가비지 컬렉션 지원으로 메모리 관리 편의성 추구 제네릭 타입은 추후 지원 예정

정적 언어

컴파일 타임에 타입이 결정되는 정적 언어다. 그러나 동적 언어처럼 타입을 직접 명시하지 않아도 된다. (자동추론)

리눅스 커널 방화벽이 제공하는 테이블과 이를 저장하는 체인, 규칙들을 구성할 수 있게 하는 응용 프로그램

테이블

• filter, nat, mangle, raw 네가지가 있으며, default는 filter임

체인

• PREROUTING : 패킷이 라우팅되기 이전에 거쳐가는 체인
• INPUT : 로컬에서 로컬으로 향하는 모든 패킷이 거쳐가는 체인
• FORWARD : 라우팅이후 로컬이 아닌 모든 패킷이 거쳐가는 체인
• OUTPUT : 외부로 나가는 패킷이 거쳐가는 체인
• POSTROUTING : 시스템에서 외부로 보내지기 직전에 거쳐가는 체인

액션

• A(APPEND) : 정책 추가
• I(INSERT) : 정책 삽입
• D(DELETE) : 정책 삭제
• R(REPLACE) : 정책 교체
• F(FLUSH) : 모든 정책 삭제
• P(POLICY) : 기본 정책 설정
• L(LIST) : 정책 나열

매치

• s : 출발지 (도메인, IP주소, 넷마스크 값을 이용하여 표기)
• d : 목적지
• p : 프로토콜 (tcp, udp, icmp... 대소문자 구분하지 않음)
• i : 입력 인터페이스
• o : 출력 인터페이스
• sport : 출발지 포트
• dport : 목적지 포트
• j : 매치된 패킷을 처리할 규칙 지정

타겟

• ACCEPT : 패킷을 허용
• DROP : 패킷을 버림
• REJECT : 패킷을 버리고 이와 동시에 적절한 응답 패킷을 전송 (icmp-port-unreachable)
• LOG : 패킷을 syslog에 기록한다.
• SNAT --to (주소) : 소스 IP를 변환 (NAT)
• DNAT --to (주소) : 목적지 IP를 변환 (NAT)
• RETURN : 호출 체인 내에서 패킷 처리를 계속함
• REDIRECT --to (주소) / --to-port (포트번호) : 리디렉션

80 포트로 들어오는 연결을 8080포트로 리디렉션

sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080