/ /

`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

AtlasThirdPartyIntegration is the Schema for the atlas 3rd party integrations API.

`Name`	유형	설명	필수 사항
`apiVersion`	문자열	atlas.mongodb.com/v1	true
`kind`	문자열	`AtlasThirdPartyIntegration`	true
`metadata`	객체	Refer to the Kubernetes `API` documentation for the fields of the `metadata` field.	true
`spec`	객체	`AtlasThirdPartyIntegrationSpec` contains the expected configuration for an integration Validations: (has(self.``externalProjectRef``) && !has(self.``projectRef``)) \|\| (!has(self.``externalProjectRef``) && has(self.``projectRef``)): must define only one project reference through `externalProjectRef` or `projectRef` (has(self.``externalProjectRef``) && has(self.``connectionSecret``)) \|\| !has(self.``externalProjectRef``): must define a local connection secret when referencing an external project has(self.type) && self.type.size() != 0: must define a type of integration !has(self.datadog) \|\| (self.type == '`DATADOG`' && has(self.datadog)): only `DATADOG` type may set datadog fields !has(self.``microsoftTeams``) \|\| (self.type == '`MICROSOFT_TEAMS`' && has(self.``microsoftTeams``)): only `MICROSOFT_TEAMS` type may set `microsoftTeams` fields !has(self.``newRelic``) \|\| (self.type == '`NEW_RELIC`' && has(self.``newRelic``)): only `NEW_RELIC` type may set `newRelic` fields !has(self.``opsGenie``) \|\| (self.type == '`OPS_GENIE`' && has(self.``opsGenie``)): only `OPS_GENIE` type may set `opsGenie` fields !has(self.prometheus) \|\| (self.type == '`PROMETHEUS`' && has(self.prometheus)): only `PROMETHEUS` type may set prometheus fields !has(self.``pagerDuty``) \|\| (self.type == '`PAGER_DUTY`' && has(self.``pagerDuty``)): only `PAGER_DUTY` type may set `pagerDuty` fields !has(self.slack) \|\| (self.type == '`SLACK`' && has(self.slack)): only `SLACK` type may set slack fields !has(self.``victorOps``) \|\| (self.type == '`VICTOR_OPS`' && has(self.``victorOps``)): only `VICTOR_OPS` type may set `victorOps` fields !has(self.webhook) \|\| (self.type == '`WEBHOOK`' && has(self.webhook)): only `WEBHOOK` type may set webhook fields	거짓
`status`	객체	`AtlasThirdPartyIntegrationStatus` holds the `status` of an integration	거짓

AtlasThirdPartyIntegration.spec

AtlasThirdPartyIntegrationSpec contains the expected configuration for an integration

`Name`	유형	설명	필수 사항
`type`	열거형	Type of the integration. Enum: `DATADOG`, `MICROSOFT_TEAMS`, `NEW_RELIC`, `OPS_GENIE`, `PAGER_DUTY`, `PROMETHEUS`, `SLACK`, `VICTOR_OPS`, `WEBHOOK`	true
`connectionSecret`	객체	Name of the secret containing Atlas `API` private and public keys.	거짓
`datadog`	객체	Datadog contains the config fields for Datadog's Integration.	거짓
`externalProjectRef`	객체	`externalProjectRef` holds the parent Atlas project `ID`. Mutually exclusive with the "`projectRef`" field.	거짓
`microsoftTeams`	객체	`MicrosoftTeams` contains the config fields for Microsoft Teams's Integration.	거짓
`newRelic`	객체	`NewRelic` contains the config fields for New Relic's Integration.	거짓
`opsGenie`	객체	`OpsGenie` contains the config fields for Ops Genie's Integration.	거짓
`pagerDuty`	객체	`PagerDuty` contains the config fields for `PagerDuty`'s Integration.	거짓
`projectRef`	객체	`projectRef` is a reference to the parent `AtlasProject` resource. Mutually exclusive with the "`externalProjectRef`" field.	거짓
`prometheus`	객체	Prometheus contains the config fields for Prometheus's Integration.	거짓
`slack`	객체	Slack contains the config fields for Slack's Integration.	거짓
`victorOps`	객체	`VictorOps` contains the config fields for `VictorOps`'s Integration.	거짓
`webhook`	객체	Webhook contains the config fields for Webhook's Integration.	거짓

AtlasThirdPartyIntegration.spec.connectionSecret

Name of the secret containing Atlas API private and public keys.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.datadog

Datadog contains the config fields for Datadog's Integration.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef holds the name of a secret containing the Datadog `API` key.	true
`region`	문자열	Region is the Datadog region	true
`sendCollectionLatencyMetrics`	열거형	`SendCollectionLatencyMetrics` toggles sending collection latency metrics. Enum: enabled, disabled Default: disabled	거짓
`sendDatabaseMetrics`	열거형	`SendDatabaseMetrics` toggles sending database metrics, including database and collection names Enum: enabled, disabled Default: disabled	거짓

AtlasThirdPartyIntegration.spec.datadog.apiKeySecretRef

APIKeySecretRef holds the name of a secret containing the Datadog API key.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.externalProjectRef

externalProjectRef holds the parent Atlas project ID. Mutually exclusive with the "projectRef" field.

`Name`	유형	설명	필수 사항
`id`	문자열	`ID` is the Atlas project `ID`.	true

AtlasThirdPartyIntegration.spec.microsoftTeams

MicrosoftTeams contains the config fields for Microsoft Teams's Integration.

`Name`	유형	설명	필수 사항
`urlSecretRef`	객체	URLSecretRef holds the name of a secret containing the Microsoft Teams secret `URL`.	true

AtlasThirdPartyIntegration.spec.microsoftTeams.urlSecretRef

URLSecretRef holds the name of a secret containing the Microsoft Teams secret URL.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.newRelic

NewRelic contains the config fields for New Relic's Integration.

`Name`	유형	설명	필수 사항
`credentialsSecretRef`	객체	`CredentialsSecretRef` holds the name of a secret containing new relic's credentials: account id, license key, read and write tokens.	true

AtlasThirdPartyIntegration.spec.newRelic.credentialsSecretRef

CredentialsSecretRef holds the name of a secret containing new relic's credentials: account id, license key, read and write tokens.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.opsGenie

OpsGenie contains the config fields for Ops Genie's Integration.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef holds the name of a secret containing Ops Genie's `API` key.	true
`region`	문자열	Region is the Ops Genie region.	true

AtlasThirdPartyIntegration.spec.opsGenie.apiKeySecretRef

APIKeySecretRef holds the name of a secret containing Ops Genie's API key.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.pagerDuty

PagerDuty contains the config fields for PagerDuty's Integration.

`Name`	유형	설명	필수 사항
`region`	문자열	Region is the Pager Duty region.	true
`serviceKeySecretRef`	객체	`ServiceKeySecretRef` holds the name of a secret containing Pager Duty service key.	true

AtlasThirdPartyIntegration.spec.pagerDuty.serviceKeySecretRef

ServiceKeySecretRef holds the name of a secret containing Pager Duty service key.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.projectRef

projectRef is a reference to the parent AtlasProject resource. Mutually exclusive with the "externalProjectRef" field.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the Kubernetes Resource	true
`namespace`	문자열	Namespace of the Kubernetes Resource	거짓

AtlasThirdPartyIntegration.spec.prometheus

Prometheus contains the config fields for Prometheus's Integration.

`Name`	유형	설명	필수 사항
`enabled`	문자열	Enabled is true when Prometheus integration is enabled.	true
`prometheusCredentialsSecretRef`	객체	`PrometheusCredentialsSecretRef` holds the name of a secret containing the Prometheus. username & password	true
`serviceDiscovery`	열거형	`ServiceDiscovery` to be used by Prometheus. Enum: file, http	true

AtlasThirdPartyIntegration.spec.prometheus.prometheusCredentialsSecretRef

PrometheusCredentialsSecretRef holds the name of a secret containing the Prometheus. username & password

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.slack

Slack contains the config fields for Slack's Integration.

`Name`	유형	설명	필수 사항
`apiTokenSecretRef`	객체	APITokenSecretRef holds the name of a secret containing the Slack `API` token.	true
`channelName`	문자열	`ChannelName` to be used by Prometheus.	true
`teamName`	문자열	`TeamName` flags whether Prometheus integration is enabled.	true

AtlasThirdPartyIntegration.spec.slack.apiTokenSecretRef

APITokenSecretRef holds the name of a secret containing the Slack API token.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.victorOps

VictorOps contains the config fields for VictorOps's Integration.

`Name`	유형	설명	필수 사항
`apiKeySecretRef`	객체	APIKeySecretRef is the name of a secret containing Victor Ops `API` key.	true
`routingKey`	문자열	`RoutingKey` holds `VictorOps` routing key.	true

AtlasThirdPartyIntegration.spec.victorOps.apiKeySecretRef

APIKeySecretRef is the name of a secret containing Victor Ops API key.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.spec.webhook

Webhook contains the config fields for Webhook's Integration.

`Name`	유형	설명	필수 사항
`urlSecretRef`	객체	URLSecretRef holds the name of a secret containing Webhook `URL` and secret.	true

AtlasThirdPartyIntegration.spec.webhook.urlSecretRef

URLSecretRef holds the name of a secret containing Webhook URL and secret.

`Name`	유형	설명	필수 사항
`name`	문자열	Name of the resource being referred to More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names	true

AtlasThirdPartyIntegration.status

AtlasThirdPartyIntegrationStatus holds the status of an integration

`Name`	유형	설명	필수 사항
`conditions`	[]object	Conditions holding the status details	거짓
`id`	문자열	`ID` of the third party integration resource in Atlas	거짓

AtlasThirdPartyIntegration.status.conditions

Condition contains details for one aspect of the current state of this API Resource.

`Name`	유형	설명	필수 사항
`lastTransitionTime`	문자열	`lastTransitionTime` is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the `API` field changed is acceptable. Format: date-time	true
`message`	문자열	message is a human readable `message` indicating details about the transition. This may be an empty string.	true
`reason`	문자열	reason contains a programmatic identifier indicating the `reason` for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and whether the values are considered a guaranteed `API`. The value should be a `CamelCase` string. This field may not be empty.	true
`status`	열거형	status of the condition, one of True, False, Unknown. Enum: True, False, Unknown	true
`type`	문자열	type of condition in `CamelCase` or in foo.example.com/`CamelCase`.	true
`observedGeneration`	integer	`observedGeneration` represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].``observedGeneration`` is 9, the condition is out of date with respect to the current state of the instance. Format: int64 Minimum: 0	거짓

돌아가기

AtlasStreamWorkspace

AtlasBackupCompliance