/ /

`AtlasDataFederation` 사용자 지정 리소스

참고

Atlas Kubernetes Operator는 정부용 Atlas에 대해 AtlasDataFederation 사용자 지정 리소스를 지원하지 않습니다.

AtlasDataFederation 사용자 지정 리소스 Atlas 에서 연합 데이터베이스 인스턴스 구성합니다. AtlasDataFederation 사용자 지정 리소스 만들면 Atlas Kubernetes Operator Atlas 에서 연합 데이터베이스 인스턴스 만들거나 업데이트 시도합니다. 연합 데이터베이스 인스턴스 사용하여 연합 쿼리를 실행수 있습니다.

중요

Custom Resource(사용자 정의 리소스)는 더 이상 기본적으로 객체를 삭제하지 않음

Atlas Kubernetes Operator 사용자 지정 리소스 구성 파일을 사용하여 Atlas 구성을 관리 하지만, Atlas Kubernetes Operator 부터는 Kubernetes 에서 삭제 사용자 지정 2.0 리소스가 더 이상 ( 기본값) Atlas 에서 삭제되지 않습니다. 대신 Atlas Kubernetes Operator Atlas 에서 해당 리소스 관리를 중지할 뿐입니다. 예시 들어, Kubernetes 에서 Custom Resource(사용자 AtlasProject 지정 리소스)를 삭제 하면 기본값 으로 Atlas Kubernetes Operator 더 이상 Atlas 에서 해당 프로젝트 자동으로 삭제하지 않습니다. 이러한 동작 변경은 우발적이거나 예기치 않은 삭제를 방지하기 위한 것입니다. 이 동작을 Atlas Kubernetes Operator 이전에 사용된 기본값 으로 되돌리는 방법 2 등 자세히 학습0., 새 기본값: Atlas Kubernetes Operator 의 삭제 보호 기능 2 을0 참조하세요.
마찬가지로, Atlas Kubernetes Operator 를 사용하여 Kubernetes 의 Atlas 프로젝트 에서 팀을 제거 하는 경우 Atlas Kubernetes Atlas Kubernetes Operator 는 Atlas 에서 팀을 삭제 하지 않습니다.

기본값 Atlas 구성 값을 암시적으로 사용하지 않으려면 원하는 구성 세부 정보를 명시적으로 정의하세요. 경우에 따라 Atlas 기본값을 상속하면 조정 루프가 발생하여 사용자 지정 리소스 READY 상태 달성하지 못할 수 있습니다. 예시 들어 AtlasDeployment 사용자 지정 리소스 에 원하는 자동 확장 동작을 명시적으로 정의하면 포함된 예시 와 같이 사용자 지정 리소스 의 정적 인스턴스 크기가 자동 확장이 활성화된 Atlas 배포서버 에 반복적으로 적용되지 않도록 할 수 있습니다.

autoScaling:
  diskGB:
    enabled: true
  compute:
    enabled: true
    scaleDownEnabled: true
    minInstanceSize: M30
    maxInstanceSize: M40

Atlas Kubernetes Operator는 Atlas Clusters API Resource (클러스터 API 리소스) 및 Advanced Clusters API Resource (고급 클러스터 API 리소스)를 사용하여 새 연합 데이터베이스 인스턴스를 생성하거나 기존 연합 데이터베이스 인스턴스를 업데이트합니다. spec.serverlessSpec 아래의 필드에 값을 지정하는 경우, Atlas Kubernetes Operator는 Atlas Serverless Instance API Resource (서버리스 인스턴스 API 리소스)를 사용하여 연합 데이터베이스 인스턴스에 대한 비공개 엔드포인트를 생성하거나 구성합니다.

Kubernetes 클러스터에서 AtlasDataFederation 리소스를 제거하면 Atlas Kubernetes Operator가 Atlas에서 연합 데이터베이스 인스턴스를 제거합니다.

예시

다음 예제에서는 비공개 엔드포인트가 구성된 AtlasDataFederation 사용자 지정 리소스 사양을 보여줍니다.

apiVersion: atlas.mongodb.com/v1
kind: AtlasDataFederation
metadata:
  name: my-federated-deployment
spec:
  projectRef:
    name: my-project
    namespace: default
  cloudProviderConfig:
    aws:
      roleId: 12345678
      testS3Bucket: my-bucket
  dataProcessRegion:
    cloudProvider: AWS
    region: OREGON_USA
  name: my-fdi
  storage:
    databases:
    - collections:
      - dataSources:
        - allowInsecure: false
          collection: my-collection
          collectionRegex:
          database: my-database
          databaseRegex:
          defaultFormat: ".avro"
          path: /
          provenanceFieldName: string
          storeName: my-data-store
          urls:
          - string:
        name: my-collection-mdb
      maxWildcardCollections: 100
      name: my-database-mdb
      views:
      - name: my-view
        pipeline:
        source: my-source-collection
    stores:
    - name: my-store
      provider: S3
      additionalStorageClasses:
      - STANDARD
      bucket: my-bucket
      delimiter: /
      includeTags: false
      prefix: data-
      public: false
      region: US_WEST_1
  privateEndpoints:
  - endpointId: vpce-3bf78b0ddee411ba1
    provider: AWS
    type: DATA_LAKE
  - endpointId: vpce-3bf78b0ddee411ba2
    provider: AWS
    type: DATA_LAKE

매개변수

Atlas Data Federation

AtlasDataFederation은 Atlas Data Federation API 의 스키마입니다.

`Name`	유형	설명	필수 사항
`apiVersion`	문자열	atlas.mongodb.com/v1	true
`kind`	문자열	`AtlasDataFederation`	true
`metadata`	객체	`metadata` 필드 의 필드에 대해서는 Kubernetes `API` 설명서를 참조하세요.	true
`spec`	객체	`DataFederationSpec` `AtlasDataFederation`의 대상 상태 정의합니다.	거짓
`status`	객체	`DataFederationStatus` `AtlasDataFederation`의 관찰된 상태 정의합니다.	거짓

AtlasDataFederation.spec

DataFederationSpec은 AtlasDataFederation의 대상 상태 정의합니다.

`Name`	유형	설명	필수 사항
`name`	문자열	연합 데이터베이스 인스턴스를 식별하는 사람이 읽을 수 있는 레이블입니다.	true
`projectRef`	객체	프로젝트는 배포서버 속한 `AtlasProject` 리소스 에 대한 참조입니다.	true
`cloudProviderConfig`	객체	이 연합 데이터베이스 인스턴스가 호스팅되는 cloud 제공자 에 대한 구성입니다.	거짓
`dataProcessRegion`	객체	연합 데이터베이스 인스턴스가 클라이언트 연결을 라우팅하는 클라우드 공급자 리전에 대한 정보입니다.	거짓
`privateEndpoints`	[] 객체	지정된 프로젝트에 추가할 연합 데이터베이스 인스턴스 및 온라인 아카이브에 대한 프라이빗 엔드포인트입니다.	거짓
`storage`	객체	각 데이터 저장 에 대한 구성 정보와 `MongoDB` Atlas 데이터베이스에 대한 매핑입니다.	거짓

AtlasDataFederation.spec.projectRef

프로젝트는 배포서버 속한 AtlasProject 리소스 에 대한 참조입니다.

`Name`	유형	설명	필수 사항
`name`	문자열	Kubernetes 리소스의 이름	true
`namespace`	문자열	Kubernetes 리소스의 네임스페이스	거짓

AtlasDataFederation.spec.cloudProviderConfig

이 연합 데이터베이스 인스턴스가 호스팅되는 cloud 제공자 에 대한 구성입니다.

`Name`	유형	설명	필수 사항
`aws`	객체	`AWS`에서 Data Federation 실행 위한 구성입니다.	거짓

AtlasDataFederation.spec.cloudProviderConfig.aws

AWS에서 Data Federation 실행 위한 구성입니다.

`Name`	유형	설명	필수 사항
`roleId`	문자열	데이터 레이크 데이터 저장소에 액세스 데 사용할 수 있는 역할 의 고유 식별자입니다. `cloudProviderConfig`을(를) 지정하는 경우 필수입니다.	거짓
`testS3Bucket`	문자열	제공된 역할 `ID` 에 액세스 권한이 있는 `S3` 데이터 버킷의 이름입니다. `cloudProviderConfig`를 지정하는 경우 필수입니다.	거짓

AtlasDataFederation.spec.dataProcessRegion

연합 데이터베이스 인스턴스가 클라이언트 연결을 라우팅하는 클라우드 공급자 리전에 대한 정보입니다.

`Name`	유형	설명	필수 사항
`cloudProvider`	열거형	연합 데이터베이스 인스턴스의 인프라를 호스팅하는 cloud 서비스의 이름입니다. 열거형: `AWS`	거짓
`region`	열거형	`region` 데이터 레이크 클라이언트 연결을 라우팅하는 의 이름입니다. `SYDNEY_AUSMUMBAI_INDFRANKFURT_DEUDUBLIN_IRL`열거형:,,,,,,,, `LONDON_GBRVIRGINIA_USAOREGON_USASAOPAULO_BRASINGAPORE_SGP`	거짓

AtlasDataFederation.spec.privateEndpoints

`Name`	유형	설명	필수 사항
`endpointId`	문자열	비공개 엔드포인트를 식별하는 고유한 22자 영숫자 문자열입니다.	거짓
`provider`	문자열	클라우드 서비스 제공자를 식별하는 인간 판독 가능 레이블. Atlas Data Lake는 Amazon Web Services만 지원합니다.	거짓
`type`	문자열	이 비공개 엔드포인트와 연결된 `type` 리소스 식별하는 사람이 읽을 수 있는 레이블입니다.	거짓

AtlasDataFederation.spec. 저장

각 데이터 저장 및 MongoDB Atlas 데이터베이스에 대한 매핑에 대한 구성 정보입니다.

`Name`	유형	설명	필수 사항
`databases`	[] 객체	이 데이터 레이크 에 대한 쿼리 가능한 `databases` 및 컬렉션이 포함된 배열입니다.	거짓
`stores`	[] 객체	데이터 레이크 에 대한 `stores` 데이터가 포함된 배열입니다.	거짓

AtlasDataFederation.spec. 저장.databases

이 데이터 레이크 와 연결된 데이터베이스입니다. 데이터베이스에는 컬렉션과 뷰가 포함됩니다.

`Name`	유형	설명	필수 사항
`collections`	[] 객체	매장 데이터 저장 에 매핑되는 `collections` 및 데이터 소스의 배열입니다.	거짓
`maxWildcardCollections`	integer	데이터베이스 의 최대 와일드카드 컬렉션 수입니다. 이는 `S3` 데이터 소스에만 적용됩니다. 최소값은 1, 최대값은 1000입니다. 기본값은 100입니다.	거짓
`name`	문자열	데이터 레이크 데이터를 매핑하는 데이터베이스 식별하는 사람이 읽을 수 있는 레이블입니다.	거짓
`views`	[] 객체	컬렉션 에 적용 집계 파이프라인의 배열입니다. 이는 `S3` 데이터 소스에만 적용됩니다.	거짓

AtlasDataFederation.spec. 저장.databases.collections

컬렉션은 매장 데이터 저장 에 매핑됩니다.

`Name`	유형	설명	필수 사항
`dataSources`	[] 객체	이 데이터 레이크 에 대한 컬렉션 에 매핑되는 데이터 저장소가 포함된 배열입니다.	거짓
`name`	문자열	`MongoDB` Atlas 데이터 저장소의 데이터를 매핑하는 컬렉션 을 식별하는 사람이 읽을 수 있는 레이블입니다.	거짓

AtlasDataFederation.spec. 저장.databases.collections.dataSources

`Name`	유형	설명	필수 사항
`allowInsecure`	부울	지정된 URL의 체계의 유효성을 검사하는 플래그입니다. true인 경우 안전하지 않은 `HTTP` 체계를 허용하고, 서버의 인증서 체인과 호스트 이름을 확인하지 않으며, 서버 에서 제공하는 모든 호스트 이름을 가진 인증서를 허용합니다. false인 경우 보안 `HTTPS` 체계만 허용합니다.	거짓
`collection`	문자열	데이터베이스 에서 `collection` 을(를) 식별하는 사람이 읽을 수 있는 레이블입니다. 와일드카드(*) 컬렉션 만들려면 이 매개변수를 생략해야 합니다.	거짓
`collectionRegex`	문자열	와일드카드(*) 컬렉션 만드는 데 사용할 정규식 패턴 .	거짓
`database`	문자열	클러스터 의 컬렉션 포함하는 데이터베이스 식별하는 사람이 읽을 수 있는 레이블입니다. 동적으로 생성된 데이터베이스에 대한 와일드카드(*) 컬렉션을 생성하려면 이 매개변수를 생략해야 합니다.	거짓
`databaseRegex`	문자열	와일드카드(*) 데이터베이스 만드는 데 사용할 정규식 패턴 .	거짓
`defaultFormat`	열거형	을(를) 검색하는 `MongoDB` `storeName`동안 Cloud가 파일확장자가 없는 파일 발견하는 경우 사용하는 파일 형식입니다.2 2Enum:.avro,.avro.bz,.avro.gz,.bson,.bson.bz,.bson.gz,.bsonx,.csv,.csv.bz,.csv2 2.gz,.json,.json.bz,.json.gz,.orc,.parquet,.tsv,.tsv.bz,.tsv.gz2	거짓
`path`	문자열	파일 `path` 는 `MongoDB` Cloud가 파일을 컬렉션 에 매핑하기 전에 `storeName` 에서 파일을 검색하고 구문 분석하는 방법을 제어합니다. 접두사 경로에서 모든 파일과 폴더를 캡처하려면 / 를 지정합니다.	거짓
`provenanceFieldName`	문자열	결과에 있는 문서의 출처를 포함하는 필드 의 이름입니다. `MongoDB` Atlas 지원되는 각 제공자 에 대해 결과에 서로 다른 필드를 반환합니다.	거짓
`storeName`	문자열	`MongoDB` Cloud가 컬렉션 에 매핑하는 데이터 저장 식별하는 사람이 읽을 수 있는 레이블입니다.	거짓
`urls`	[]string	공개적으로 액세스할 수 있는 데이터 파일의 URL입니다. 인증 필요한 URL은 지정할 수 없습니다. Atlas Data Lake 각 `URL`에 대한 파티션을 만듭니다. 비어 있거나 생략된 경우 Data Lake `storeName` 매개변수에 지정된 저장 의 URL을 사용합니다.	거짓

AtlasDataFederation.spec. 저장.databases.views

`Name`	유형	설명	필수 사항
`name`	문자열	collection의 집계 파이프라인에 해당하는 뷰를 식별하는 인간 판독 가능 레이블.	거짓
`pipeline`	문자열	소스 컬렉션 에 적용 할 애그리게이션 `pipeline` 단계입니다.	거짓
`source`	문자열	뷰의 `source` 컬렉션 식별하는 사람이 읽을 수 있는 레이블입니다.	거짓

AtlasDataFederation.spec. 저장

저장은 데이터가 저장되는 위치를 정의하는 설정 그룹 입니다.

`Name`	유형	설명	필수 사항
`additionalStorageClasses`	[]string	`AWS` `S3` 저장 클래스의 컬렉션입니다. Atlas Data Lake 쿼리 결과에 이러한 저장 클래스의 파일을 포함합니다.	거짓
`bucket`	문자열	`AWS` `S3` 버킷을 식별하는 사람이 읽을 수 있는 레이블입니다. 이 레이블은 데이터 레이크 구성된 `AWS` ID 및 액세스 관리(`IAM`) 자격 증명 사용하여 액세스 할 수 있는 `S3` `bucket` 의 이름과 정확히 일치해야 합니다.	거짓
`delimiter`	문자열	데이터 저장 에서 경로 세그먼트를 구분하는 `delimiter` 입니다. `MongoDB` Atlas `delimiter` 를 사용하여 계층 디렉토리 구조의 `S3` 버킷을 효율적으로 탐색합니다. `S3` 객체 키에서 지원하는 모든 문자를 구분 기호로 지정할 수 있습니다.	거짓
`includeTags`	부울	지정된 경로의 파일에 `S3` 태그를 추가 파티션 속성으로 사용할지 여부를 나타내는 플래그입니다. true로 설정하다 하면 데이터 레이크 `S3` 태그를 추가 파티션 속성으로 추가하고 각 태그를 지정하다 각 문서 에 연결하는 새로운 최상위 `BSON` 요소를 추가합니다.	거짓
`name`	문자열	데이터 저장 식별하는 사람이 읽을 수 있는 레이블입니다. `storeName` 필드 매핑 구성의 일부로 이 값을 참조합니다. `MongoDB` Atlas 데이터 저장 로 사용하려면 데이터 레이크 서버리스 인스턴스 또는 `M10` 이상의 클러스터 필요합니다.	거짓
`prefix`	문자열	`S3` 버킷에서 파일을 검색할 때 `MongoDB` 클라우드가 적용하는 접두사입니다. 데이터 저장 경로에 `prefix` 값을 추가하여 수집할 파일의 전체 경로를 생성합니다. 생략하면 `MongoDB` Cloud는 `S3` 버킷의 루트에서 모든 파일을 검색합니다.	거짓
`provider`	문자열	데이터 저장소에 사용되는 `provider` 입니다.	거짓
`public`	부울	버킷의 공개 여부를 나타내는 플래그입니다. true로 설정하다 하면 `MongoDB` Cloud는 구성된 `AWS` ID 및 액세스 관리(`IAM`) 역할 사용하여 `S3` 버킷에 액세스 하지 않습니다. false로 설정하다 경우, 구성된 `AWS` `IAM` 역할 에 `S3` 버킷에 액세스 할 수 있는 권한이 포함되어야 합니다.	거짓
`region`	문자열	`MongoDB` 클라우드가 `AWS`호스팅 `MongoDB` 클러스터 노드를 배포하는 물리적 위치 입니다. 선택한 `region` 는 데이터베이스에 액세스하는 클라이언트의 네트워크 지연 시간 에 영향을 줄 수 있습니다. `MongoDB` Atlas 전용 클러스터 배포할 때 해당 제공자 및 리전 에 `VPC` 또는 `VPC` 연결이 존재하는지 확인합니다. 그렇지 않은 경우 `MongoDB` Atlas 배포서버 의 일부로 생성합니다. 새 `VPC` 피어링 연결을 하나의 `CIDR` 차단 및 리전 으로 제한하려면 먼저 연결을 생성합니다. 연결이 시작된 후 클러스터 를 배포합니다.	거짓

AtlasDataFederation.status

DataFederationStatus는 AtlasDataFederation의 관찰된 상태 정의합니다.

`Name`	유형	설명	필수 사항
`conditions`	[] 객체	조건은 Atlas Custom Resource(사용자 지정 리소스)의 현재 상태 보여주는 상태 목록입니다.	true
`mongoDBVersion`	문자열	`MongoDBVersion` `MongoDB` 은(는) 클러스터 실행하는 버전입니다. 형식.	거짓
`observedGeneration`	integer	`ObservedGeneration` Atlas Operator가 인식하는 리소스 사양의 생성을 나타냅니다. Atlas Operator는 리소스 조정을 시작하는 즉시 이 필드 ' 메타데이터 .generation' 값으로 업데이트합니다. 형식: int64	거짓

AtlasDataFederation.status.conditions

조건은 특정 점 의 Atlas Custom Resource(사용자 지정 리소스) 상태 를 설명합니다.

`Name`	유형	설명	필수 사항
`status`	문자열	조건의 상태입니다. 참, 거짓, 알 수 없음 중 하나입니다.	true
`type`	문자열	Atlas Custom Resource(사용자 지정 리소스) 조건 유형입니다.	true
`lastTransitionTime`	문자열	마지막으로 조건이 한 상태에서 다른 상태로 전환된 시간입니다. 형식으로 `ISO` 8601 표시됩니다. 형식: 날짜-시간	거짓
`message`	문자열	전환에 대한 세부 정보를 제공하는 `message` 입니다.	거짓
`reason`	문자열	조건의 마지막 전환에 대한 `reason` 입니다.	거짓

돌아가기

AtlasTeam

AtlasFederatedAuth