Docs Menu
Docs Home
/
MongoDB Atlas
/
Atlas Stream Processing

연결 레지스트리 관리

이 페이지의 내용

  • 전제 조건
  • 연결 레지스트리의 연결 보기
  • 연결 레지스트리에 연결 추가
  • 연결 레지스트리에서 연결 수정
  • 연결 레지스트리에서 연결 삭제

각 스트림 처리 인스턴스는 스트리밍 데이터 소스 또는 싱크에 대해 구성된 모든 연결을 연결 레지스트리에 저장합니다. 이 페이지의 절차에서는 Atlas Stream Processing 연결을 만들고 구성하는 과정을 안내합니다.

전제 조건

연결을 생성하고 구성하려면 다음이 필요합니다.

  • Atlas 프로젝트

  • 연결 레지스트리를 관리하기 위한 Project Owner 또는 Project Stream Processing Owner 역할이 있는 Atlas 사용자

    참고

    Project Owner 역할이 있으면 데이터베이스 배포를 만들고, 프로젝트 액세스 및 프로젝트 설정을 관리하고, IP 액세스 목록 항목을 관리하는 등의 작업을 수행할 수 있습니다.

    Project Stream Processing Owner 역할은 스트림 처리 인스턴스 보기, 생성, 삭제 및 편집, 연결 레지스트리에서 연결 보기, 추가, 수정 및 삭제와 같은 Atlas Stream Processing 작업을 활성화합니다.

    두 역할의 차이점에 대해 자세히 알아보려면 프로젝트 역할 을 참조하세요.

  • Atlas 클러스터

연결 레지스트리의 연결 보기

Atlas Stream Processing 인스턴스에 대한 연결을 보려면 다음과 같이 하세요:

Atlas CLI를 사용하여 지정한 하나의 Atlas Stream Processing 인스턴스의 모든 연결을 나열하려면 다음 명령을 실행합니다.

atlas streams connections list [options]

Atlas CLI를 사용하여 지정한 하나의 Atlas Stream Processing 연결에 대한 세부 정보를 반환하려면 다음 명령을 실행합니다.

atlas streams connections describe <streamConnectionName> [options]

이전 명령의 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 스트림 연결 목록 및 Atlas 스트림 연결 설명에 대한 Atlas CLI 문서를 참조하세요.

팁

참조: 관련 링크

1

Atlas에서 Stream Processing 프로젝트의 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Services 제목 아래의 Stream Processing 을 클릭합니다.

    스트림 처리 페이지가 표시됩니다.

2

Connection Registry 페이지로 이동합니다.

  1. 보려는 연결 레지스트리가 포함된 스트림 처리 인스턴스의 개요 패널을 찾습니다.

  2. Configure를 클릭합니다.

  3. 0}Connection Registry 탭을 선택합니다.

Atlas Stream Processing은 인스턴스 연결 레지스트리에서 사용 가능한 모든 연결을 표시합니다.

Atlas 관리 API는 연결 레지스트리에서 하나 또는 모든 연결을 검색하기 위한 다양한 엔드포인트를 제공합니다.

연결 레지스트리에서 하나의 연결 보기

연결 레지스트리의 모든 연결 나열

mongosh 을 사용하여 사용 가능한 모든 연결을 나열하려면 sp.listConnections() 메서드를 사용합니다. 스트림 처리 인스턴스의 연결 레지스트리에서 각 연결을 설명하는 문서 목록을 반환합니다. 다음과 같은 구문을 가집니다.

sp.listConnections()

연결 레지스트리에 연결 추가

Atlas Stream Processing은 다음과 같은 연결 유형을 지원합니다.

각 유형에는 고유한 구성 요구 사항이 있습니다.

Apache Kafka 연결 추가

스트림 처리 인스턴스에 Kafka 연결을 추가하려면 다음을 수행합니다.

Atlas CLI를 사용하여 지정한 Atlas Stream Processing 인스턴스에 대해 하나의 연결을 생성하려면 다음 명령을 실행합니다.

atlas streams connections create [connectionName] [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 스트림 연결 생성에 대한 Atlas CLI 설명서를 참조하세요.

팁

참조: 관련 링크

Atlas CLI를 사용하여 스트림 처리 인스턴스를 만들 때 .json 구성 파일을 제공하여 새 연결의 매개변수를 정의해야 합니다. 이 파일의 형식은 정의하는 연결 유형에 따라 달라집니다.

Apache Kafka 의 경우 연결하려면 다음 구문으로 구성 파일을 제공합니다.

{
  "name": "<name>",
  "type": "Kafka",
  "bootstrapServers": "<address:port>, ...",
  "security": {
    "protocol": "<protocol>"
  },
  "authentication": {
    "mechanism": "<auth-mechanism>",
    "username": "<username>",
    "password": "<password>"
  }
}
1

Atlas에서 Stream Processing 프로젝트의 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Services 제목 아래의 Stream Processing 을 클릭합니다.

    스트림 처리 페이지가 표시됩니다.

2

로 Connection Registry 이동합니다.

  1. 수정하려는 스트림 처리 인스턴스의 개요 패널을 찾아 Configure 을 클릭합니다.

  2. 0}Connection Registry 탭을 선택합니다.

3

+ Add connection을(를) 클릭합니다.

4

새 연결을 추가합니다.

  1. Kafka 연결을 선택합니다.

  2. Connection Name 을(를) 제공합니다. 각 연결 이름은 스트림 처리 인스턴스 내에서 고유해야 합니다. Atlas Stream Processing 애그리게이션에서 연결을 참조하는 데 사용되는 이름입니다.

  3. Network Access 유형을 선택합니다. Atlas Stream Processing은 Public IP 또는 VPC Peering 연결을 지원합니다.

    Atlas Stream Processing을 위한 VPC 피어링은 현재 비공개 미리 보기로 제공됩니다. 자세한 내용은 계정 팀에 문의하세요.

    Public IP 버튼을 클릭합니다. 이 네트워크 액세스 유형에는 추가 구성이 필요하지 않습니다.

    1. VPC Peering 버튼을 클릭합니다.

    2. Enable VPC Peering 를 켭니다.

    3. 드롭다운 메뉴에서 기존 VPC 피어링 연결 중 하나를 선택합니다. VPC 피어링 연결이 없는 경우 Atlas 네트워크 피어링 연결을 구성하세요.

  4. 하나 이상의 부트스트랩 서버 에 대한 IP 주소 지정 Apache Kafka 의 경우 시스템.

  5. 드롭다운 메뉴에서 Security Protocol Method 을 선택합니다.

    Atlas Stream Processing은 SASL_PLAINTEXT 또는 SASL_SSL 을(를) 지원합니다.

    SASL_PLAINTEXT VPC 피어링과 호환되지 않습니다. VPC 피어링을 사용하려면 SASL_SSL 메서드를 선택해야 합니다.

    1. 드롭다운 메뉴에서 SASL Mechanism 을 선택합니다.

      Atlas Stream Processing은 다음을 지원합니다.

      • PLAIN

      • SCRAM-SHA-256

      • SCRAM-SHA-512

    2. 인증을 위해 Username 를 제공합니다.

    3. 인증을 위한 비밀번호를 입력합니다.

    4. Add connection를 클릭합니다.

    1. 드롭다운 메뉴에서 SASL Mechanism 을 선택합니다.

      Atlas Stream Processing은 다음을 지원합니다.

      • PLAIN

      • SCRAM-SHA-256

      • SCRAM-SHA-512

    2. Upload 을(를) 클릭하여 Certificate Authority PEM file을(를) 업로드합니다.

    3. 인증을 위해 Username 를 제공합니다.

    4. 인증을 위한 비밀번호를 입력합니다.

    5. Add connection를 클릭합니다.

Atlas 관리 API는 연결 레지스트리에 연결을 추가하기 위한 엔드포인트를 제공합니다.

연결 레지스트리에 연결 추가

중요

Apache Kafka 와 같은 외부 연결을 추가한 후 클러스터를 연결 레지스트리에 추가하려면 해당 외부 연결에 대한 액세스 목록에 Atlas IP 주소를 추가해야 합니다. 자세한 내용 은 Atlas 컨트롤플레인에 대한 액세스 허용을 참조하세요.

Atlas 연결 추가

스트림 처리 인스턴스에 Atlas 데이터베이스 연결을 추가하려면 다음을 수행합니다.

Atlas CLI를 사용하여 지정한 Atlas Stream Processing 인스턴스에 대해 하나의 연결을 생성하려면 다음 명령을 실행합니다.

atlas streams connections create [connectionName] [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 스트림 연결 생성에 대한 Atlas CLI 설명서를 참조하세요.

팁

참조: 관련 링크

Atlas CLI를 사용하여 스트림 처리 인스턴스를 만들 때 .json 구성 파일을 제공하여 새 연결의 매개변수를 정의해야 합니다. 이 파일의 형식은 정의하는 연결 유형에 따라 달라집니다.

Atlas 데이터베이스 연결의 경우 다음 구문으로 구성 파일을 제공합니다.

{
  "name": "<name>",
  "type": "Cluster",
  "clusterName": "<clusterName>"
}
1

Atlas에서 Stream Processing 프로젝트의 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Services 제목 아래의 Stream Processing 을 클릭합니다.

    스트림 처리 페이지가 표시됩니다.

2

로 Connection Registry 이동합니다.

  1. 수정하려는 스트림 처리 인스턴스의 개요 패널을 찾아 Configure 을 클릭합니다.

  2. 0}Connection Registry 탭을 선택합니다.

3

+ Add connection을(를) 클릭합니다.

4

새 연결을 추가합니다.

Atlas 변경 스트림에 대한 새 연결을 생성하려면 다음을 수행합니다.

  1. Atlas Database 연결을 선택합니다.

  2. Connection Name 을(를) 제공합니다. 각 연결 이름은 스트림 처리 인스턴스 내에서 고유해야 합니다. Atlas Stream Processing 애그리게이션에서 연결을 참조하는 데 사용되는 이름입니다.

  3. 드롭다운 메뉴에서 Atlas Cluster 을 선택합니다. Atlas Stream Processing은 전용 계층 클러스터에서만 사용할 수 있습니다.

  4. Add connection를 클릭합니다.

Atlas 관리 API는 연결 레지스트리에 연결을 추가하기 위한 엔드포인트를 제공합니다.

연결 레지스트리에 연결 추가

연결 레지스트리에서 연결 수정

연결 레지스트리에서 연결을 수정하려면 다음과 같이 하세요:

Atlas CLI를 사용하여 지정한 스트림 처리 인스턴스에서 한 연결의 세부 정보를 수정하려면 다음 명령을 실행합니다.

atlas streams connections update <connectionName> [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 스트림 연결 업데이트에 대한 Atlas CLI 설명서를 참조하세요.

팁

참조: 관련 링크

1

Atlas에서 Stream Processing 프로젝트의 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Services 제목 아래의 Stream Processing 을 클릭합니다.

    스트림 처리 페이지가 표시됩니다.

2

로 Connection Registry 이동합니다.

수정하려는 연결 레지스트리가 포함된 스트림 처리 인스턴스의 개요 패널을 찾아 오른쪽 상단에서 Configure 를 클릭합니다.

3

Connection Registry 탭을 선택합니다.

4

연결을 수정합니다.

  1. 테이블에서 수정하려는 연결의 Actions 열에 있는 연필 아이콘을 클릭합니다.

    현재 스트림 프로세서에서 사용 중이 아닌 경우에만 연결을 편집할 수 있습니다. 사용 중인 연결을 편집하려면 먼저 해당 연결을 사용하는 모든 스트림 프로세서를 중지합니다.

  2. 수정하려는 필드를 수정합니다.

  3. Save changes를 클릭합니다.

Atlas 관리 API는 스트림 처리 인스턴스를 편집하기 위한 엔드포인트를 제공합니다.

1개의 스트림 인스턴스 삭제

연결 레지스트리에서 연결 삭제

연결 레지스트리에서 연결을 삭제하려면 다음과 같이 하세요:

Atlas CLI를 사용하여 지정한 Atlas Stream Processing 인스턴스에서 연결 한 개를 제거하려면 다음 명령을 실행합니다.

atlas streams connections delete <connectionName> [options]

명령 구문 및 매개변수에 대해 자세히 알아보려면 Atlas 스트림 연결 삭제에 대한 Atlas CLI 설명서를 참조하세요.

팁

참조: 관련 링크

1

Atlas에서 Stream Processing 프로젝트의 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Services 제목 아래의 Stream Processing 을 클릭합니다.

    스트림 처리 페이지가 표시됩니다.

2

로 Connection Registry 이동합니다.

  1. 수정하려는 연결 레지스트리가 포함된 스트림 처리 인스턴스의 개요 패널을 찾습니다.

  2. 오른쪽 상단에서 Configure 을(를) 클릭합니다.

  3. 0}Connection Registry 탭을 선택합니다.

3

연결을 삭제합니다.

  1. 테이블에서 수정하려는 연결에 대해 해당 항목의 Actions 열에 있는 휴지통 아이콘을 클릭합니다.

  2. 메시지가 표시되면 Delete 을(를) 클릭합니다.

Atlas 관리 API는 스트림 처리 인스턴스를 편집하기 위한 엔드포인트를 제공합니다.

1개의 스트림 인스턴스 삭제

돌아가기

스트림 처리 인스턴스 관리