export * from './lib/ajax/http.service';
export * from './lib/i18n/i18n';
다음으로 apps/gateway/web/src/main.tsx 에서 initI18N을 초기화 한다.
import * as ReactDOM from 'react-dom';
import { initI18N } from '@rnm/ui';
import App from './app/app';
import { config } from './environments/environment';
initI18N(config);
ReactDOM.render(<App />, document.getElementById('root'));
개발환경에서 Dashboard Web Dev Server로 연결하기
Gateway - Dashboard 로컬 개발시에는 총 4개의 프로세스가 구동되고 상호 연관성을 갖는다.
Gateway API (NodeJS & NestJS), Gateway Frontend (Web Dev Server & React) 로 Gateway하나에 두개의 프로세스가 구동된다.
Dashboard API, Dashboard Frontend 도 두개의 프로세스가 구동된다.
4개 프로세스간의 관계
개발시에 전체 루틴을 처리하고 싶다면 위와 같은 Proxy 설정이 되어야 한다. 환경 설정을 다음 순서로 진행한다.
Step-1) Gateway Web에서 Gateway API로 Proxy
apps/gateway/web/proxy.conf.json 환경은 Dashboard, Configuration, Back-Office 모두를 proxy 한다. 그리고 apps/gateway/web/project.json 안에 proxy.conf.json과 포트 9000 을 설정한다.
Step-2) Gateway API에서 Dashboard Web으로 Proxy
apps/gateway/api/src/environments/config.json 에서 REVERSE_ADDRESS가 기존 Dashboard API 의 8001 이 아니라, Dashboard Web의 9001 로 포트를 변경하면 된다.
Step-3) Dashboard Web 에서 Dashboard API로 proxy
Dashboard API로 proxy 하기위해 apps/dashboard/web/proxy.conf.json 파일을 추가한다. api 호출은 dashboard api의 8001로 proxy 한다.
baseHref: "/dashboard/"를 설정한다. "/dashboard"로 하면 안된다.
Step-4) Dashboard API 변경사항
apps/dashboard/api/src/public/dashboard 하위 내역을 모드 apps/dashboard/api/src/public으로 옮기고, dashboard 폴더를 삭제한다.
apps/dashboard/api/src/environments/config.json 의 HTTP 포트는 8001 이다.
테스트
먼저 콘솔에서 gateway, dashboard web을 구동한다.
$> nx serve gateway-web
NX Web Development Server is listening at http://localhost:9000/
$> nx serve dashboard-web
> NX Web Development Server is listening at http://localhost:9001/
VSCode에서 gateway, dashboard api를 구동한다.
브라우져에서 http://localhost:9000 을 호출하고, 로그인 해서 dashboard web 의 index.html 이 호출되는지 체크한다.
// 코드: https://gist.github.com/ysyun/845ddd32467bb50af654e1e4605a4b50
// .zshrc
autoload -Uz add-zsh-hook
load-nvmrc() {
local _CUR_NODE_VER="$(nvm version)"
local _NVMRC_PATH="$(nvm_find_nvmrc)"
if [[ -n "${_NVMRC_PATH}" ]]; then
local _NVMRC_NODE_VER="$(nvm version "$(cat "${_NVMRC_PATH}")")"
if [[ "${_NVMRC_NODE_VER}" == 'N/A' ]]; then
local compcontext='yn:yes or no:(y n)'
vared -cp "Install the unmet version ($(cat "${_NVMRC_PATH}")) in nvm (y/n) ?" _ANSWER
if [[ "${_ANSWER}" =~ '^y(es)?$' ]] ; then
nvm install
fi
elif [[ "${_NVMRC_NODE_VER}" != "${_CUR_NODE_VER}" ]]; then
nvm use
fi
elif [[ "${_CUR_NODE_VER}" != "$(nvm version default)" ]]; then
echo -e "Reverting to the default version in nvm"
nvm use default
fi
}
add-zsh-hook chpwd load-nvmrc
load-nvmrc
// 작업 폴더에 .nvmrc 파일을 생성하고, 버전을 기입힌다. 아래 내용 참조
// .nvmrc
14.18.0
Step-2) NX 개발환경 생성
create-nx-workspace@latest를 이용하고, .nvmrc 파일을 생성한다. .zshrc가 적용되고, rnm-stack 폴더에 진입하면 자동으로 14.18.0 버전이 적용된다. rnm은 React Nest Micro-service의 약어이다.
$> npx create-nx-workspace@latest
✔ Workspace name (e.g., org name) · rnm-stack
✔ What to create in the new workspace · react
✔ Application name · gateway/web
✔ Default stylesheet format · scss
✔ Use Nx Cloud? (It's free and doesn't require registration.) · No
$> cd rnm-stack
$> echo "14.18.0" > .nvmrc
다음은 api 애플리케이션을 Nest기반으로 생성한다.
// nest 제너레이터 설치
$> yarn add -D @nrwl/nest@latest
// api 생성
$> nx g @nrwl/nest:app gateway/api
다음으로 루트폴더에 있는 workspace.json 파일을 각 api와 web폴더에 project.json 파일을 생성하여 설정을 옮긴다. 이후 생성되는 애플리케이션들은 자동으로 project.json 파일로 생성된다.
// workspace.json
{
"version": 2,
"projects": {
"gateway-api": "apps/gateway/api", <== project.json 파일의 위치 지정
"gateway-web": "apps/gateway/web",
"gateway/web-e2e": "apps/gateway/web-e2e"
},
... 생략 ...
"defaultProject": "gateway-web"
}
project.json 파일들
테스트 "nx serve gateway-web" 을 수행하면 정상적으로 dev server가 수행된다.
$> nx serve gateway-web
> nx run gateway-web:serve
> NX Web Development Server is listening at http://localhost:4200/
나머지 dashboard, configuration, back-office도 생성한다.
// react application
$> nx g @nrwl/react:app dashboard/web
$> nx g @nrwl/react:app configuration/web
$> nx g @nrwl/react:app back-office/web
// nest application
$> nx g @nrwl/nest:app dashboard/api
$> nx g @nrwl/nest:app configuration/api
$> nx g @nrwl/nest:app back-office/api
전체 생성 애플리케이션과 workspace.json 내역
Libraries 생성
다음으로 libs 폴더 하위로 라이브러리들을 생성한다. @rnm/page, @rnm/ui, @rnm/domain, @rnm/shared 로 import하여 사용한다.
page
ui
domain
shared
$> nx g @nrwl/react:lib page --importPath=@rnm/page --publishable
$> nx g @nrwl/react:lib ui --importPath=@rnm/ui --publishable
$> nx g @nrwl/nest:lib domain --importPath=@rnm/domain --publishable
$> nx g @nrwl/nest:lib shared --importPath=@rnm/shared --publishable
libs 폴더밑으로 4개 라이브러리 생성
Micro Service Communication Channel 설정
다음은 애플리케이션간의 연결을 위한 통신부분을 설정한다. NestJS 기반으로 microservice 생성을 위해 패키지를 설치한다. NestJS버전을 7.6.18 버전으로 업데이트 한다. (현재 8.*은 microservice 버그가 있다. 작동불능)
$> yarn add @nestjs/microservices
// package.json 에서 nestjs의 모든 패키지의 버전을 업데이트 한다.
"dependencies": {
"@nestjs/common": "^7.6.18", <== 요기
"@nestjs/core": "^7.6.18", <== 요기
"@nestjs/microservices": "^7.6.18", <== 요기
"@nestjs/platform-express": "^7.6.18", <== 요기
"@nestjs/serve-static": "^2.2.2",
"core-js": "^3.6.5",
"react": "17.0.2",
"react-dom": "17.0.2",
"react-router-dom": "5.2.0",
"reflect-metadata": "^0.1.13",
"regenerator-runtime": "0.13.7",
"rxjs": "~6.6.3",
"tslib": "^2.0.0"
},
"devDependencies": {
"@nestjs/schematics": "^7.3.1", <== 요기, 7최신이 7.3.1
"@nestjs/testing": "^7.6.18", <== 요기
...
}
// nestjs 모든 패키지의 업데이트 버전을 재설치한다.
$> yarn
Step-1) Micro Service 설정
dashboard, configuration, back-office 3가지 micro service
http server & static server
dashboard: 8001, configuration: 8002, back-office: 8002 HTTP port를 사용한다.
api server
dashboard: 8100, configuration: 8200, back-office: 8300 TCP port를 사용한다.
apps/dashboard/api/src 하위로 public 폴더를 하위로 dashboard 폴더를 추가로 생성한 후 index.html 파일을 생성한다.
apps/dashboard/api/src/environments폴더에 config.json 파일을 생성한다.
apps/dashboard/api/project.json 에 "assets" 파트에 설정을 추가한다. "assets": ["apps/dashboard/api/src/environments", "apps/dashboard/api/src/public"]
libs/shared/src/lib 밑에 configuration 폴더를 생성하고, config.service.ts 와 config.model.ts을 생성한다. config.json 파일을 읽기위한 용도이다. index.ts에 export도 설정한다.
apps/dashboard/api/src/main.ts 파일을 수정한다. http server를 위한 listen port를 설정하고, microservice client가 연결토록 TCP로 연결 준비를 한다. loadMicroServiceCofiguration 함수를 "@rnm/shared" 패키지로 부터 위치 투명하게 (마치 node_modules에 설치된 것처럼) import 할 수 있다.
import { Logger } from '@nestjs/common';
import { NestFactory } from '@nestjs/core';
import { Transport, MicroserviceOptions } from '@nestjs/microservices';
import { loadMicroServiceConfiguration } from '@rnm/shared';
import { AppModule } from './app/app.module';
async function bootstrap() {
const app = await NestFactory.create(AppModule);
// Load config.json file
const config = loadMicroServiceConfiguration();
// // Setup tcp server for api
const options: MicroserviceOptions = {
transport: Transport.TCP,
options: { host: config.TCP_HOST, port: config.TCP_PORT || 8100 }
};
app.connectMicroservice(options);
app.startAllMicroservices();
// // Setup http server for web
const httpPort = config.HTTP_PORT || process.env.HTTP_PORT || 8001;
const globalPrefix = config.GLOBAL_API_PREFIX || '/api';
app.setGlobalPrefix(globalPrefix);
await app.listen(httpPort, () => {
Logger.log(`Listening at http://localhost:${httpPort}${globalPrefix}`);
});
}
bootstrap();
확인 & 테스트
// LISTEN 포트 확인
$> netstat -an |grep 8100
tcp4 0 0 *.8100 *.* LISTEN
$> netstat -an |grep 8001
tcp46 0 0 *.8001 *.* LISTEN
// gateway 실행
$> nx serve dashboard-api
// other console
$> curl -X GET "http://localhost:8001/api"
{"message":"Welcome to dashboard/api in libs"}
configuration, back-office도 동일하게 적용한다.
Step-2) Micro Service의 HTTP port가 static file 서비스토록 설정
apps/dashboard/api/src/app/app.module.ts 에 static 환경을 설정한다. rootPath는 public 폴더를 만든다. exclude는 global prefix인 api를 제외한다. public 폴더에 index.html 을 만들어 본다. 향후 react기반 SPA 번들파일을 위치할 것이다.
import { Module } from '@nestjs/common';
import { ServeStaticModule } from '@nestjs/serve-static';
import { join } from 'path';
import { DashboardApiAppService } from '@rnm/domain';
import { AppController } from './app.controller';
@Module({
imports: [
ServeStaticModule.forRoot({
rootPath: join(__dirname, 'public'),
exclude: ['/api*', '/dashboard/api*'],
}),
],
controllers: [AppController],
providers: [DashboardApiAppService],
})
export class AppModule { }
// index.html
dashboard home
재실행 후, dashboard context path로 브라우져에서 확인한다. public/dashboard/assets/images 밑으로 샘플 이미지 복사
Step-3) Micro Service의 응답을 위한 TCP MessagePattern 데코레이터 생성
apps/dashboard/api/src/app/app.controller.ts 에서 TCP 요청에 대한 응답 코드를 작성한다. TCP는 MessagePattern 데코레이터를 통해 응답하고 반환은 Primitive type, Promise, Observable 다 가능하다. 만일 Observable로 하면 gateway 측에서 Observable로 대응할 수 있다.
{ cmd: 'dashboard-sum' } 은 gateway로부터 오는 Key이다.
import { Controller, Get } from '@nestjs/common';
import { MessagePattern } from '@nestjs/microservices';
import { DashboardApiAppService } from '@rnm/domain';
import { from, Observable } from 'rxjs';
@Controller()
export class AppController {
constructor(private readonly appService: DashboardApiAppService) { }
@Get()
getData() {
return this.appService.getData();
}
@MessagePattern({ cmd: 'dashboard-sum' })
accumulate(data: number[]): Observable<number> {
console.log('calling sum from dashboard....');
const sum = data[0] + data[1] + data[2];
return from([sum]);
}
}
테스트는 Gateway까지 설정후 진행한다.
Step-4) Gateway 설정
gateway
http server & static server
reverse proxy
api client
config.json 파일을 apps/gateway/api/src/environment 폴더밑으로 생성하고 하기와 같이 설정한다.
apps/gateway/api/src/app/app.module.ts에서는 static file 서비스 폴더를 지정한다. reverse proxy를 위해 아래 3개의 exclude를 추가한다. web context처럼 사용될 것이다.
dashboard
configuration
back-office
import { Module } from '@nestjs/common';
import { ServeStaticModule } from '@nestjs/serve-static';
import { join } from 'path';
import { GatewayApiAppService } from '@rnm/domain';
import { AppController } from './app.controller';
import { DashboardModule } from './dashboard/dashboard.module';
@Module({
imports: [
ServeStaticModule.forRoot({
rootPath: join(__dirname, 'public'),
exclude: [
'/api/gateway*', '/api/dashboard*',
'/dashboard*', '/configuration*', '/back-office*'
],
}),
DashboardModule
],
controllers: [AppController],
providers: [GatewayApiAppService]
})
export class AppModule { }
gateway, back-office, configuration, dashboard등에서 사용하는 api service 를 domain library로 옮기고, 명칭을 수정하여 import해서 사용한다. 예로 GatewayApiAppService, DashboardApiAppService와 같다. api service중에 라이브러리성으로 옮겨도 될 만한 것들을 domain 라이브러리 밑으로 작성한다. 예로 여러 곳에서 호출되는 공통 api의 경우 또는 업무적인 묶음단위로 api를 관리하고 싶을 경우이다. 해당 api를 라이브러리로 빼는 이유는 향후 다른 UI에서 사용하거나 또는 UI가 바뀌어도 업무적인 api에 변경이 없을 경우를 가정한 것이다.
micro service 인 dashboard, configuration, back-office는 자신의 http web server로써 static file을 서비스하고, tcp를 통해 api를 전송한다. 개발시에는 gateway를 구동하지 않고, micro service만 실행한다면 http를 통해 api 서비스 추가하면 될 것이다.
Gateway에서 reverse proxy되는 3개 context
http-proxy-middleware를 설치한다.
$> yarn add http-proxy-middleware
다음으로 apps/gateway/api/src/app 폴더 밑으로 dashboard 폴더를 생성하고, dashboard용 controller, service, module과 dashboard.proxy.ts 파일들을 생성한다.
NestMiddleware를 상속받아 use를 구현한다.
// dashboard.proxy.ts ==> dashboard-proxy.middleware.ts 로 추후 명칭 변경됨
/* eslint-disable @typescript-eslint/no-explicit-any */
import { NestMiddleware, Logger } from '@nestjs/common';
import { loadGatewayConfiguration } from '@rnm/shared';
import { createProxyMiddleware } from 'http-proxy-middleware';
export class DashboardReverseProxyMiddleware implements NestMiddleware {
private config = loadGatewayConfiguration();
private proxyOptions = {
target: this.config.DASHBOARD.REVERSE_ADDRESS,
secure: false,
onProxyReq: (proxyReq: any, req: any, res: any) => {
Logger.debug(`[DashboardReverseProxyMiddleware]: Proxying ${req.method} request originally made to '${req.url}'`);
},
};
private proxy: any = createProxyMiddleware(this.proxyOptions);
use(req: any, res: any, next: () => void) {
this.proxy(req, res, next);
}
}
dashboard.module.ts에 다음과 같이 dashboard에 TCP로 접근하는 Client설정을 한다. 그리고 ProxyMiddleware를 설정한다.
import { MiddlewareConsumer, Module, NestModule, RequestMethod } from '@nestjs/common';
import { ClientsModule, Transport } from '@nestjs/microservices';
import { loadGatewayConfiguration } from '@rnm/shared';
import { DashboardController } from './dashboard.controller';
import { DashboardReverseProxyMiddleware } from './dashboard.proxy';
import { DashboardService } from './dashboard.service';
const config = loadGatewayConfiguration();
@Module({
imports: [
// dashboard쪽 api 호출을 위한 TCP Client Proxy 등록
ClientsModule.register([
{
name: "DASHBOARD",
transport: Transport.TCP,
options: {
host: config.DASHBOARD.TCP_HOST,
port: config.DASHBOARD.TCP_PORT
}
}
])
],
controllers: [DashboardController],
providers: [DashboardService],
})
export class DashboardModule implements NestModule {
// middleware 적용
configure(consumer: MiddlewareConsumer) {
consumer
.apply(DashboardReverseProxyMiddleware)
.forRoutes({ path: config.DASHBOARD.REVERSE_CONTEXT, method: RequestMethod.ALL });
}
}
전체 코드 준비는 되었고, 다음 글에서는 MS Code에서 Debugging을 통해 위의 코드를 테스트해 본다.
