Docs Menu
Docs Home
/
MongoDB Atlas
/
데이터와 상호 작용
/
트리거
/
함수

값 정의 및 액세스

이 페이지의 내용

  • 값 정의
  • 값에 액세스

값 은 Atlas 에 저장된 정적 데이터에 대한 명명된 참조로, Atlas Functions 에서 액세스 할 수 있습니다. 값은 구성 상수를 함수에 직접 하드코딩하는 대신 사용할 수 있습니다.

즉, 값을 사용하면 배포별 구성 데이터를 앱 의 비즈니스 로직에서 분리할 수 있습니다.

값은 두 가지 유형의 데이터로 해석할 수 있습니다:

  • 일반 텍스트: 사용자가 정의한 일반 JSON 객체, 배열 또는 문자열 값으로 해석됩니다.

  • 비밀: 사용자가 정의한 비밀 값으로 확인됩니다.

값 정의

UI 에서 또는 App Services CLI 를 사용하여 새 값을 정의할 수 있습니다.

1

페이지로 이동 Values

  1. Triggers 페이지로 이동합니다.

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

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

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

      트리거 페이지가 표시됩니다.

  2. Linked App Service: Triggers 링크를 클릭합니다.

  3. 사이드바에서 Build 제목 아래의 Values 을 클릭합니다.

  4. Create a Value를 클릭합니다.

2

값 이름 지정

고유한 Value Name 을(를) 입력합니다. 이 이름은 함수 내 값을 참조하는 방법입니다.

참고

값 이름 제한

값 이름은 64 자를 초과할 수 없으며 ASCII 문자, 숫자, 밑줄 및 하이픈만 포함할 수 있습니다. 첫 번째 문자는 문자 또는 숫자여야 합니다.

3

값 정의

  1. Value 유형을 선택합니다.

  2. 일반 텍스트 값을 정의하거나 Secret 값에 대한 링크를 정의합니다.

    • 일반 텍스트 값을 정의하려면 Custom Content 을 입력하고 입력 상자에 일반 텍스트 값을 입력합니다.

    • 기존 Secret의 값에 연결하려면 Link to Secret 를 선택하고 드롭다운에서 Secret을 선택합니다.

    • 새 Secret 값에 연결하려면 Link to Secret 을(를) 선택한 다음 표시되는 입력 상자에 새 Secret의 이름과 새 Secret의 값을 입력합니다.

    시크릿 생성에 대한 자세한 내용은 시크릿 생성을 참조하세요.

4

값 저장

새 값에 이름을 지정하고 정의한 후 Save 을(를) 클릭합니다.

저장하면 함수에서 즉시 값에 액세스 할 수 있습니다.

1

MongoDB Atlas 사용자 인증하기

MongoDB Atlas 관리 API 키 를 사용하여 App Services CLI 에 로그인 합니다.

appservices login --api-key="<API KEY>" --private-api-key="<PRIVATE KEY>"
2

앱의 최신 구성 파일 가져오기

다음 명령을 실행하여 구성 파일의 로컬 복사본을 가져옵니다.

appservices pull --remote=<App ID>

기본값 으로 이 명령은 파일을 현재 작업 디렉토리 로 가져옵니다. 선택 사항인 --local 플래그를 사용하여 디렉토리 경로를 지정할 수 있습니다.

3

값 구성 추가

로컬 애플리케이션 의 values 하위 디렉토리에 새 값에 대한 JSON 구성 파일 을 추가합니다.

touch values/<ValueName>.json

각 값은 자체 JSON 파일 에 정의되어 있습니다. 예를 예시 myValue 이라는 값은 /values/myValue.json 파일 에 정의되어 있습니다.

구성 파일은 다음과 같은 일반적인 형식을 가져야 합니다.

values/<ValueName>.json
{
   "name": "<Value Name>",
   "from_secret": <boolean>,
   "value": <Stored JSON Value|Secret Name>
}
필드
설명
name
값의 고유한 이름입니다. 이 이름은 함수 및 규칙의 값을 참조하는 방법입니다.
from_secret
기본값: false. true 인 경우 Value는 일반 텍스트 JSON Value 대신 Secret 을 노출합니다.
value

값이 참조될 때 노출하는 저장된 데이터:

  • from_secret 가 false 인 경우, value 는 표준 JSON 문자열, 배열 또는 객체일 수 있습니다.

  • from_secret 이 true 인 경우 value 은 값이 노출하는 시크릿의 이름을 포함하는 문자열입니다.

4

변경 사항 배포:

다음 명령을 실행하여 변경 사항을 배포 합니다.

appservices push

값에 액세스

context.values 모듈을 사용하여 Atlas Function 에서 Value에 저장된 데이터에 액세스 할 수 있습니다.

context.values.get("<Value Name>")

예를 예시, 다음 함수는 활성 사용자의 ID가 일반 텍스트 배열 값 adminUsers 에 포함된 경우 true 을 반환합니다.

값을 사용하는 함수 예시
exports = function() {
   const adminUsers = context.values.get("adminUsers");
   const isAdminUser = adminUsers.indexOf(context.user.id) > 0;
   return isAdminUser;
}

돌아가기

MongoDB API 참조

이 페이지의 내용