/ /

`AtlasThirdPartyIntegration` 사용자 지정 리소스

AtlasThirdPartyIntegration 사용자 지정 리소스 Atlas 프로젝트 에서 타사 통합을 구성합니다. 이러한 리소스를 사용하면 다양한 모니터링 서비스와의 타사통합을 관리 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 타사 서비스 통합 API 리소스를 사용하여 다음 조치 중 하나를 수행합니다.

새로운 타사 서비스 통합을 생성합니다.
기존 타사 서비스 통합을 업데이트합니다.

예시

기본 예시

다음 예시 my-project 프로젝트 내에서 DataDog 통합을 정의하는 AtlasThirdPartyIntegration 사용자 지정 리소스 보여줍니다.

apiVersion: atlas.mongodb.com/v1
kind: AtlasThirdPartyIntegration
metadata:
  name: my-atlas-integ
spec:
  projectRef:
    name: my-project
    namespace: my-operator-namespace
  type: DATADOG
  datadog:
    apiKeySecretRef:
      name: datadog-secret
    region: US
    sendCollectionLatencyMetrics: enabled
    sendDatabaseMetrics: enabled

독립적인 CRD 예제

다음 예시 AtlasThirdPartyIntegration 기본 예제 에 정의된 것과 동일한 DataDog 통합을 정의하는 독립적인 CRD를 보여줍니다. 이 사용자 지정 리소스 정의를 사용하면 이 리소스 정의하는 데 사용되는 동일한 Atlas Kubernetes Operator 인스턴스 에서 관리 하지 않는 프로젝트 에서 이러한 타사 통합을 생성할 수 있습니다. 독립적인 작업을 활성화 하려면 projectRef 대신 externalProjectRef 를 사용해야 하며, 이 리소스 상위 프로젝트 로부터 API 자격 증명 상속할 수 없으므로 connectionSecret 를 직접 제공해야 합니다.

apiVersion: atlas.mongodb.com/v1
kind: AtlasThirdPartyIntegration
metadata:
  name: my-atlas-integ
spec:
  externalProjectRef:
    projectID: 66e2f2b621571b7e69a89b66
  connectionSecret:
    name: atlas-connection-secret
  type: DATADOG
  datadog:
    apiKeySecretRef:
      name: datadog-secret
    region: US
    sendCollectionLatencyMetrics: enabled
    sendDatabaseMetrics: enabled

매개변수

AtlasTirdPartyIntegration

AtlasTirdPartyIntegration은 Atlas 3타사 통합 API 의 스키마입니다.

`Name`	유형	설명	필수 사항
`apiVersion`	문자열	atlas.mongodb.com/v1	true
`kind`	문자열	`AtlasThirdPartyIntegration`	true
`metadata`	객체	`metadata` 필드 의 필드에 대해서는 Kubernetes `API` 설명서를 참조하세요.	true
`spec`	객체	`AtlasThirdPartyIntegrationSpec` 에는 통합 유효성 검사에 대한 예상 구성이 포함되어 있습니다. (has(self.``externalProjectRef``) && !has(self.``projectRef``)) \|\| (!has(self.``externalProjectRef``) && has(self.``projectRef``)): `externalProjectRef` 또는 `projectRef`를 통해 프로젝트 참조를 하나만 정의해야 합니다. (has(self.``externalProjectRef``) && has(self.``connectionSecret``)) \|\| !has(self.``externalProjectRef``): 외부 프로젝트 참조할 때 로컬 연결 비밀을 정의해야 합니다. has(self.type) && self.type.size() != 0: 통합 유형을 정의해야 합니다. !has(self.datadog) \|\| (self.type == '`DATADOG`' && has(self.datadog)): `DATADOG` 유형만 datadog 필드를 설정할 수 있습니다. !has(self.``microsoftTeams``) \|\| (self.type == '`MICROSOFT_TEAMS`' && has(self.``microsoftTeams``)): `MICROSOFT_TEAMS` 유형만 `microsoftTeams` 필드를 설정할 수 있습니다. !has(self.``newRelic``) \|\| (self.type == '`NEW_RELIC`' && has(self.``newRelic``)): `NEW_RELIC` 유형만 `newRelic` 필드를 설정할 수 있습니다. !has(self.``opsGenie``) \|\| (self.type == '`OPS_GENIE`' && has(self.``opsGenie``)): `OPS_GENIE` 유형만 `opsGenie` 필드를 설정할 수 있습니다. !has(self.prometheus) \|\| (self.type == '`PROMETHEUS`' && has(self.prometheus)): `PROMETHEUS` 유형만 프로메테우스 필드를 설정할 수 있습니다. !has(self.``pagerDuty``) \|\| (self.type == '`PAGER_DUTY`' && has(self.``pagerDuty``)): `PAGER_DUTY` 유형만 `pagerDuty` 필드를 설정할 수 있습니다. !has(self.slack) \|\| (self.type == '`SLACK`' && has(self.slack)): `SLACK` 유형만 slack 필드를 설정할 수 있습니다. !has(self.``victorOps``) \|\| (self.type == '`VICTOR_OPS`' && has(self.``victorOps``)): `VICTOR_OPS` 유형만 `victorOps` 필드를 설정할 수 있습니다. !has(self.webhook) \|\| (self.type == '`WEBHOOK`' && has(self.webhook)): `WEBHOOK` 유형만 웹훅 필드를 설정할 수 있습니다.	거짓
`status`	객체	`AtlasThirdPartyIntegrationStatus` 통합의 `status` 를 보유합니다.	거짓

AtlasTirdPartyIntegration.spec

AtlasTirdPartyIntegrationSpec에는 통합에 대한 예상 구성이 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`type`	열거형	통합 유형입니다. 열거형: `DATADOG`, `MICROSOFT_TEAMS`, `NEW_RELIC`, `OPS_GENIE`, `PAGER_DUTY`, `PROMETHEUS`, `SLACK`, `VICTOR_OPS`, `WEBHOOK`	true
`connectionSecret`	객체	Atlas `API` 비공개 및 공개 키가 포함된 시크릿의 이름입니다.	거짓
`datadog`	객체	Datadog에는 Datadog의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`externalProjectRef`	객체	`externalProjectRef` 상위 Atlas 프로젝트 `ID`을(를) 보유합니다. "`projectRef`" 필드 와 상호 배타적입니다.	거짓
`microsoftTeams`	객체	`MicrosoftTeams` Microsoft Teams 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`newRelic`	객체	`NewRelic` New Relic's Integration을 위한 구성 필드가 포함되어 있습니다.	거짓
`opsGenie`	객체	`OpsGenie` Ops Genie의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`pagerDuty`	객체	`PagerDuty` `PagerDuty`의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`projectRef`	객체	`projectRef` 상위 `AtlasProject` 리소스 에 대한 참조입니다. "`externalProjectRef`" 필드 와 상호 배타적입니다.	거짓
`prometheus`	객체	Prometheus에는 Prometheus의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`slack`	객체	Slack Slack의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`victorOps`	객체	`VictorOps` `VictorOps`의 통합을 위한 구성 필드가 포함되어 있습니다.	거짓
`webhook`	객체	웹훅에는 웹훅 통합을 위한 구성 필드가 포함되어 있습니다.	거짓

AtlasTirdPartyIntegration.spec.connectionSecret

Atlas API 비공개 및 공개 키가 포함된 시크릿의 이름입니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.datadog

Datadog에는 Datadog의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef에는 Datadog `API` 키가 포함된 시크릿의 이름이 들어 있습니다.	true
`region`	문자열	리전은 Datadog 리전 입니다.	true
`sendCollectionLatencyMetrics`	열거형	`SendCollectionLatencyMetrics` 컬렉션 지연 시간 지표 토글합니다. 열거형: 활성화, 비활성화 기본값: 비활성화	거짓
`sendDatabaseMetrics`	열거형	`SendDatabaseMetrics` 데이터베이스 및 컬렉션 이름을 포함한 데이터베이스 지표 전송을 토글합니다. 열거형: enabled, disabled 기본값: disabled	거짓

AtlasTirdPartyIntegration.spec.datadog.apiKeySecretRef

APIKeySecretRef에는 Datadog API 키가 포함된 시크릿의 이름이 들어 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.externalProjectRef

externalProjectRef는 상위 Atlas 그룹 ID 보유합니다. "projectRef" 필드 와 상호 배타적입니다.

`Name`	유형	설명	필수 사항
`id`	문자열	`ID` Atlas 프로젝트 `ID`입니다.	true

AtlasTirdPartyIntegration.spec.microsoftTeams

MicrosoftTeams에는 Microsoft Teams의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`urlSecretRef`	객체	URLSecretRef에는 Microsoft Teams 시크릿 `URL`이 포함된 시크릿의 이름이 있습니다.	true

AtlasTirdPartyIntegration.spec.microsoftTeams.urlSecretRef

URLSecretRef에는 Microsoft Teams 시크릿 URL 포함된 시크릿의 이름이 들어 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.newRelic

NewRelic에는 New Relic의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`credentialsSecretRef`	객체	`CredentialsSecretRef` 계정 ID, 라이선스 키, 읽기 및 쓰기 (write) 토큰(read and write token) 등 새 유물의 자격 증명 포함된 시크릿의 이름을 보유합니다.	true

AtlasTirdPartyIntegration.spec.newRelic.credentialsSecretRef

CredentialsSecretRef에는 계정 ID, 라이선스 키, 읽기 및 쓰기 (write) 토큰 등 새 유물의 자격 증명 포함된 시크릿 이름이 들어 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.opsGenie

OpsGenie에는 Ops Genie's 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef에는 Ops Genie의 `API` 키가 포함된 시크릿의 이름이 있습니다.	true
`region`	문자열	리전은 Ops Genie 리전 입니다.	true

AtlasTirdPartyIntegration.spec.opsGenie.apiKeySecretRef

APIKeySecretRef에는 Ops Genie의 API 키가 포함된 시크릿의 이름이 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.pagerDuty

PagerDuty에는 PagerDuty의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`region`	문자열	리전은 호출기 작업 리전 입니다.	true
`serviceKeySecretRef`	객체	`ServiceKeySecretRef` 호출기 듀티 서비스 키가 포함된 시크릿의 이름을 보유합니다.	true

AtlasTirdPartyIntegration.spec.pagerDuty.serviceKeySecretRef

ServiceKeySecretRef에는 호출기 듀티 서비스 키가 포함된 시크릿의 이름이 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.projectRef

projectRef는 상위 AtlasProject 리소스 에 대한 참조입니다. "externalProjectRef" 필드 와 상호 배타적입니다.

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

AtlasTirdPartyIntegration.spec.prometheus

Prometheus에는 Prometheus의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`enabled`	문자열	Enabled는 Prometheus 통합이 활성화된 경우 true입니다.	true
`prometheusCredentialsSecretRef`	객체	`PrometheusCredentialsSecretRef` Prometheus가 포함된 시크릿의 이름을 보유합니다. 사용자 이름 & 비밀번호	true
`serviceDiscovery`	열거형	`ServiceDiscovery` Prometheus에서 사용할 수 있습니다. 열거형: 파일, http	true

AtlasTirdPartyIntegration.spec.prometheus.prometheusCredentialsSecretRef

PrometheusCredentialsSecretRef에는 Prometheus를 포함하는 시크릿의 이름이 있습니다. 사용자 이름 & 비밀번호

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.slack

Slack Slack의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`apiTokenSecretRef`	객체	APITokenSecretRef에는 Slack `API` 토큰이 포함된 시크릿의 이름이 있습니다.	true
`channelName`	문자열	`ChannelName` Prometheus에서 사용할 수 있습니다.	true
`teamName`	문자열	`TeamName` Prometheus 통합의 활성화 여부를 플래그합니다.	true

AtlasTirdPartyIntegration.spec.slack.apiTokenSecretRef

APITokenSecretRef에는 Slack API 토큰이 포함된 시크릿의 이름이 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.victorOps

VictorOps에는 VictorOps의 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef는 Victor Ops `API` 키가 포함된 시크릿의 이름입니다.	true
`routingKey`	문자열	`RoutingKey` `VictorOps` 라우팅 키를 보유합니다.	true

AtlasTirdPartyIntegration.spec.victorOps.apiKeySecretRef

APIKeySecretRef는 Victor Ops API 키가 포함된 시크릿의 이름입니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.spec.webhook

웹훅에는 웹훅 통합을 위한 구성 필드가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`urlSecretRef`	객체	URLSecretRef에는 Webhook `URL` 와 시크릿이 포함된 시크릿의 이름이 있습니다.	true

AtlasTirdPartyIntegration.spec.webhook.urlSecretRef

URLSecretRef에는 웹훅 URL 과 시크릿이 포함된 시크릿의 이름이 들어 있습니다.

`Name`	유형	설명	필수 사항
`name`	문자열	참조되는 리소스 의 이름 추가 정보: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasTirdPartyIntegration.status

AtlasTirdPartyIntegrationStatus는 통합 상태를 보유합니다.

`Name`	유형	설명	필수 사항
`conditions`	[] 객체	상태 세부 정보를 보유하는 조건	거짓
`id`	문자열	`ID` Atlas 의 타사 통합 리소스	거짓

AtlasTirdPartyIntegration.status.conditions

조건에는 이 API 리소스의 현재 상태 중 한 가지 측면에 대한 세부 정보가 포함되어 있습니다.

`Name`	유형	설명	필수 사항
`lastTransitionTime`	문자열	`lastTransitionTime` 조건이 한 상태에서 다른 상태로 전환된 마지막 시간입니다. 이는 기본 조건이 변경된 경우여야 합니다. 이를 알 수 없는 경우 `API` 필드 변경된 시간을 사용할 수 있습니다. 형식: 날짜-시간	true
`message`	문자열	메시지는 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 `message` 입니다. 빈 문자열일 수 있습니다.	true
`reason`	문자열	이유에 조건의 마지막 전환에 대한 `reason` 을(를) 나타내는 프로그래밍 식별자가 포함되어 있습니다. 특정 조건 유형의 생산자는 이 필드에 대한 예상 값과 의미, 그리고 값이 보장 `API`으로 간주되는지 여부를 정의할 수 있습니다. 값은 `CamelCase` 문자열이어야 합니다. 이 필드 비어 있을 수 없습니다.	true
`status`	열거형	True, False, Unknown 중 하나의 상태입니다. 열거형: 참, 거짓, 알 수 없음	true
`type`	문자열	`CamelCase` 또는 foo의 조건 유형입니다. 예시.com/`CamelCase`.	true
`observedGeneration`	integer	`observedGeneration` 를 나타냅니다. 조건이 설정하다 메타데이터 . 생성입니다. 인스턴스 들어 다음과 같습니다. 메타데이터 .generation 이 현재 12 이지만 .status.conditions[x].``observedGeneration`` 이 9 인 경우, 인스턴스 의 현재 상태 와 관련하여 조건이 오래된 상태입니다. 형식: int64 최소값: 0	거짓

돌아가기

AtlasStreamWorkspace

AtlasBackupCompliance