AWS에서 DB 리소스 동기화

Overview

QueryPie 에서는 데이터베이스 등록 및 관리를 위한 AWS 연동을 지원합니다. AWS 내의 리소스를 동기화하여 QueryPie 에서 관리하는 데이터베이스로 등록하고, 사용자 및 그룹에 동기화해온 데이터베이스에 대한 접근 권한을 부여하고 정책을 설정할 수 있습니다.

QueryPie 에서 AWS 연동 정보 등록하기

1. Database 설정 메뉴에서 Cloud Provider 메뉴로 이동합니다.
2. 우측 상단의 Create Provider 버튼을 클릭합니다.
3. Name 항목에 해당 프로바이더를 구분할 수 있는 이름을 입력합니다.
4. Cloud Provider 항목에서 Amazon Web Services 를 선택합니다.
5. Region 항목에서 동기화하고자 하는 리소스의 리전을 선택합니다.
6. 리소스를 동기화하기 위해 필요한 Credential 정보를 입력합니다.
   • 각각의 Credential 방식에 대한 설명은 하단의 Credential 타입별 인증 방식 설정하기 를 참고합니다.
7. Database Type Filter 항목에서 동기화하고자 하는 리소스들을 선택합니다.
8. Search Filter 를 사용하여 동기화하고자 하는 일부 유형의 리소스 목록을 가져올 수 있습니다.
   1. Search Filter는 AWS의 검색 방식과 동일하게 작동합니다. 이름, 호스트, OS, 태그 등의 값을 필터로 사용할 수 있으며 아래 순서대로 Enter 키를 활용하여 검색 조건 및 필터를 편리하게 입력하실 수 있습니다.
      1. Key 값 입력 후 Enter → 검색 조건 선택 후 Enter → Value 값 입력 후 Enter
9. Replication Frequency 항목에서 동기화 방식을 선택합니다.
   1. Manual : 동기화를 하고자 하는 시점에만 수동으로 동기화하는 방식입니다.
   2. Scheduling : 주기적인 스케쥴링을 통해 리소스를 동기화하는 방식입니다. Cron Expressions를 제공합니다.
10. Auto Configuration Upon Initial Synchronization Cloud Provider에서 처음 동기화하는 DB의 일부 값을 사용자가 지정 할 수 있습니다. 초기값 설정은 Cloud Provider 저장 후 수정할 수 없습니다. 이 설정의 변경이 필요한 경우, Cloud Provider 삭제 후 다시 등록을 해야 합니다.

• Tag : 동기화된 DB에 자동으로 태그를 추가할 수 있습니다.
  • 태그 값에 {vpcid}를 입력하면, 해당 DB가 속한 Cloud의 VPC ID가 자동으로 채워집니다.
  • 예: 태그 Key를 “Network”로 설정하고 Value를 {vpcid}로 입력하면, DB가 “vpc-1a2b3c4d” VPC에 있을 경우 “Network: vpc-1a2b3c4d” 태그가 자동 생성됩니다.

11. Save 버튼을 클릭하여 Cloud Provider 를 저장합니다.

Credential 타입별 인증 방식 설정하기

• Default Credentials (Instance Profile) : QueryPie 서버가 같은 AWS 계정에 설치되어 있는 경우, QueryPie가 설치된 EC2 인스턴스 IAM 권한에 정책을 할당하여 같은 AWS 내의 리소스를 동기화할 수 있습니다. 필요한 리소스에 맞는 정책을 할당해주세요.
• Cross Account Role : IAM 역할을 생성하여 다른 AWS 계정의 리소스를 동기화할 수 있습니다. 화면에 표시된 스텝에 따라 동기화를 위한 권한을 생성하고 정책을 할당해주세요. (해당 Credential 을 통해 리소스를 동기화하기 위해서는 환경변수 파일 AWS_ACCOUNT_ID 항목에 QueryPie 가 설치된 AWS 계정을 설정해야 합니다)
• Access Key : Synchronize 버튼 클릭시 AWS 계정의 access key 및 secret key를 입력하는 수동 동기화 방식을 기본 제공합니다.
  QueryPie 10.2.2 부터 “Save Credential for Synchronization” 옵션을 제공하여 Credential type로 access key를 사용 할 때도 스케줄을 통한 동기화가 가능하도록 개선되었습니다. ****

등록된 AWS Cloud Provider 동기화 및 관리

1. Database 설정 메뉴에서 Cloud Provider 메뉴로 이동합니다.
2. 등록한 Cloud Provider 를 클릭하여 세부 정보 화면으로 들어갑니다.
3. 우측 상단의 Synchronize 버튼을 클릭하면 AWS 에서 리소스를 동기화할 수 있습니다.
4. 표시되는 Synchronization Log 에서 동기화 진행 상황을 확인할 수 있고, Administrator > General > Systems > Jobs 메뉴에서도 동기화 히스토리를 확인할 수 있습니다.
5. Cloud Provider 를 한번 등록하고 나면 Provider 기본 정보 및 인증정보는 변경할 수 없습니다.
   1. Name: 변경 가능
   2. Cloud Provider: 변경 불가
   3. Region: 변경 불가
   4. Credential: 변경 불가
      1. “Save Credential for Synchronization” : 비활성화 상태는 활성화로 변경할 수 있으나 활성화 상태를 비활성화로 전환 불가
   5. Role ARN: 변경 불가
   6. Database Type Filter: 변경 가능
   7. Replication Frequency: 변경 가능

동기화 가능한 리소스 항목

• Amazon RDS (MySQL, MariaDB, PostgreSQL, SQL Server, Oracle), DynamoDB, Redshift, DocumentDB, Athena, Redis (ElastiCache)