Spring Cloud의 오픈소스.
MSA의 기반 구조가 되는 Service Discovery 의 한 종류로 IP, PORT, ID값을 저장 / 관리하는 Rest 기반 미들웨어 서버.
* Service Discovery : MSA에서 다수의 서비스 관리가 필요함에 따라 서비스 호출 경로 등의 정보들을 저장, 관리하는 것.
=> 클라이언트가 서비스 호출 시 해당 서비스의 위치를 Eureka 에게 물어봄. (굳이 물어보는 이유? MSA에서는 서비스들의 IP와 PORT가 지속적으로 변함. 이를 관리하고 있는것이 Eureka 이기 때문.)
간단한 설정과 서비스별 LB(로드밸런싱) 이 가능한 장점.
Eureka 는 Server 와 Client로 나눔.
- MSA 내 Client 서비스가 시작되면 유레카 Server 에 해당 Client 등록됨.
- 주기적으로 ping으로 서버를 확인하며 리스트를 관리함.
PM2의 역할과 사용법을 간단하게 알아보자.
공식 홈페이지에 나온 설명을 보면
PM2 is a daemon process manager that will help you manage and keep your application online. 요약하면 PM2는 어플리케이션의 관리와 온라인상태를 유지하도록 돕는 역할을 하는 데몬 프로세스 관리자 라고 한다.
$ npm install pm2@latest -g
또는
$ yarn global add pm2
위 명령어로 최신버젼을 설치할 수 있다.
이 명령어로 간단한 pm2의 사용예를 볼 수 있다.
pm2 examples
app.js 라는 소스가 있다는 가정하에
$ pm2 start app.js
이 명령어 한 줄로 쉽게 서버를 데몬화 하고 모니터링 할 수 있다.
$ pm2 restart app_name
$ pm2 reload app_name
$ pm2 stop app_name
$ pm2 delete app_name
app_name 대신에 all 이나 id 를 사용할 수 있다.
$ pm2 [list|ls|status]
$ pm2 logs // 기본 15줄의 로그가 보인다.
$ pm2 logs --lines 200 // 여러줄을 보고 싶을 경우 --lines 옵션을 사용한다.
실시간 로그도 간단한 명령어 하나로 확인 가능하다.
$ pm2 monit
이 명령어로 대쉬보드 형태로 모니터링도 가능하다.
pm2를 클러스터 모드로 실행하지 않으면 fork 모드로 실행이 되는데 fork모드는 싱글스레드로만 동작한다.
pm2의 장점인 멀티 스레드를 활용하기 위해 클러스터 모드로 실행해보자.
--watch : PM2가 어플리케이션 변경사항을 자동으로 감지하여 서버를 재시작함
-i (코어수) : 클러스터 모드로 실행할 시 사용할 코어수. max 로 적을시 cpu 코어 수 만큼 할당됨
--name : 어플리케이션 이름
--log (경로) : 로그 파일 경로
-- arg1 arg2 arg3 : 스크립트에 전달 될 파라미터
--restart-delay (딜레이 시간) : 재시작시 딜레이 시간 지정 (ms)
--no-autorestart : 재시작 불가능하도록 설정함
클러스터를 더욱 편하게 관리하기 위해 전용 설정파일을 이용할 수도 있다.
$ pm2 ecosystem
File C:\ecosystem.config.js generated
위 명령어는 자동으로 ecosystem.config.js 파일을 생성한다.
이 파일에서 클러스터 옵션들을 설정하여 사용할 수 있다.
// ecosystem.config.js 설정 예
module.exports = {
apps : [{
name : "app1",
script : "./app.js",
env_production: {
NODE_ENV: "production"
},
env_development: {
NODE_ENV: "development"
}
}]
}
ecosystem.config.js 을 실행하는 것으로 해당 옵션이 실행된다.
하단에는 간단히 적은 옵션들.
Spring Cloud OpenFeign에 관해 간단하게 알아보자.
// Gradle 기준 예시
compile("org.springframework.cloud:spring-cloud-dependencies:Finchley.SR3")
compile("org.springframework.cloud:spring-cloud-starter-openfeign:2.1.4.RELEASE")
@SpringBootApplication
@EnableFeignClients // 요거 추가 필요.
public class WebApplication {
public static void main(String[] args) {
SpringApplication.run(WebApplication.class, args);
}
}
jpa 사용법과 유사하다.
interface 를 만들고,
@FeignClient 어노테이션을 정의하고
호출하기만 하면 된다.
// 동일한 도메인을 이용하는 여러 API의 경우 @FeignClient URL 속성에 공통부분을 적어주고,
// interface 내부에 메서드를 정의할 때 개별 url 뒷부분의을 적어주면 이용 가능하다.
@FeignClient(name = "testApi", url = "https://api.test.com", configuration = TestApi.Configuration.class)
public interface TestApi {
@GetMapping(value = "/abc/auth", headers = "Accept=application/json")
String getAuth(@RequestHeader("aaa") String param1, @RequestHeader("bbb") String param2); // 헤더에 들어갈 파라미터를 정의할 수도 있다.
@GetMapping(value = "/def/select", headers = "Accept=application/json")
List<UserDao> getSelect(@SpringQueryMap UserDao param);
// interface 내에 설정을 정의할 수도 있다.
class Configuration {
@Bean
Encoder feignFormEncoder(ObjectFactory<HttpMessageConverters> converters) {
return new SpringFormEncoder(new SpringEncoder(converters));
}
}
}
위 클래스 안의 메서드를 호출하기만 하면 API 통신이 가능하다.
OpenFeign 이 제공하는 타임아웃은 두 종류가 있다.
시간은 ms 기준으로, 1000 = 1초 이다.
설정은 properties 파일과 java Configuration 에서도 가능하며, properties가 우선순위를 가진다.
각 클라이언트 별로 다른 설정이 필요하면 @FeignClient 에 직접 Configuration을 설정하면 된다.
#yml 사용 예
feign:
client:
config:
default:
connectTimeout: 15000
readTimeout: 15000
로그는 각각의 Feign client 마다 만들어지며 기본적으로 로그의 이름은 Feign client를 사용하는 인터페이스 명이다. Feign logging 은 오직 DEBUG level 에서 동작한다.
다음은 full 속성으로 로그를 설정한 예제이다.
@Configuration
public class FooConfiguration {
@Bean
Logger.Level feignLoggerLevel() {
return Logger.Level.FULL;
}
}
실무에 필요한 HTTP 핵심 기능과 HTTP API설계 방법을 학습한다.
클라이언트가 서버에 요청을 하면, 서버는 요청에 대한 처리 상태를 숫자로 반환하는 것
요청을 받은 서버에서 쿠키를 클라이언트(웹 브라우저)로 보내고 클라이언트는 쿠키를 받으면 도메인 서버 이름으로 정렬된 쿠키 디렉토리에 쿠키(정보)를 저장한다.
이후 클라이언트가 동일한 서버로 HTTP 요청을 보내면 저장된 쿠키도 같이 전송되며, 만약 서버에서 쿠키에 업데이트된 내용이 있으면 응답할 때 다시 업데이트된 쿠키를 보내준다.
/*
* 클라이언트 설정
* request 요청 script에서 credentials 옵션을 설정해 준다.
*/
// credentials 설정 옵션 값
same-origin (기본값) : 같은 출처 간 요청에만 인증 정보 전송 가능
include : 모든 요청에 인증 정보 전송 가능
omit : 모든 요청에 인증 정보 전송 불가
// 서버 설정
Access-Control-Allow-Credentials : true
Access-Control-Allow-Origin : "*" 불가
Access-Control-Allow-Methods : "*" 불가
Access-Control-Allow-Headers : "*" 불가