Apigee Integration 및 Cloud Pub/Sub 시작하기

Apigee X 문서입니다.
Apigee Edge 문서 보기

이 튜토리얼에서는 Apigee Integration 및 Cloud Pub/Sub 트리거를 사용하여 샘플 통합을 만드는 방법을 보여줍니다. 아래 단계에서는 전체 통합을 실행하기 위해 필요한 Cloud Pub/Sub 트리거, 태스크, 변수, 데이터 매핑을 구성하는 방법을 설명합니다. 이 튜토리얼에서는 Pub/Sub 주제를 만들고, Cloud Pub/Sub 트리거와 통합을 만들어 Pub/Sub 주제를 리슨하고, 데이터 매핑을 사용하여 Pub/Sub 메시지를 변환하고, 이메일을 전송합니다. 이 모든 작업은 통합 디자이너 내에서 수행됩니다.

시작하기 전에

이 튜토리얼을 시작하기 전에 다음 단계를 따르세요.

  • Apigee 로그인 사용자 인증 정보 및 조직 세부정보를 확인합니다. 이 정보는 디자이너 내에서 통합 기능에 액세스하기 위해 필요합니다.
  • 새 Cloud Pub/Sub 주제를 만듭니다. 이 튜토리얼에서는 IOT 기기로부터 온도 값(캘빈)을 읽는 Pub/Sub 주제를 사용한다고 가정합니다. 이 주제가 실제로 기기에 연결되어 있을 필요는 없습니다. 이 튜토리얼에서는 주제를 리슨하고 트리거 시 태스크를 수행하는 통합 기능을 테스트합니다.

    이 튜토리얼의 목적에 따라 샘플 주제를 만들려면 다음 안내를 따르세요.

    1. Cloud Console에서 Pub/Sub 주제 페이지로 이동합니다.

      Pub/Sub 주제 페이지로 이동

    2. 주제 만들기를 클릭합니다.
    3. 주제 ID 필드에 고유한 주제 이름을 제공합니다. 이 튜토리얼에서는 temperaturesensor를 입력합니다.
    4. 저장을 클릭합니다.

새 통합 만들기

새 통합을 만들려면 다음 단계를 수행합니다.

  1. Apigee UI로 이동하고 로그인합니다.
  2. UI 왼쪽 상단의 드롭다운 메뉴를 사용해 조직을 선택합니다.
  3. 개발 > 통합을 클릭합니다.
  4. 새로 만들기를 클릭합니다.
  5. 통합 만들기 대화상자에 이름과 설명을 입력합니다. 예를 들면 my-test-integration입니다.
  6. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
  7. 만들기를 클릭하여 통합 디자이너를 엽니다.

Cloud Pub/Sub 트리거 추가

통합에 Cloud Pub/Sub 트리거를 추가하려면 다음 단계를 따르세요.
  1. 통합 디자이너에서 + 태스크/트리거 추가를 클릭하여 태스크를 보고 선택 대화상자를 트리거합니다.
  2. 트리거를 클릭하여 사용 가능한 트리거를 봅니다.
  3. Cloud Pub/Sub 트리거 요소를 디자이너로 드래그합니다.

Cloud Pub/Sub 트리거 구성

통합 디자이너에서 Cloud Pub/Sub 트리거 요소를 클릭하여 트리거 구성 창을 봅니다.

Pub/Sub 주제 필드에 다음 형식으로 트리거로 리슨할 주제를 지정합니다. 각 항목의 의미는 다음과 같습니다.

  • PROJECT_ID는 주제가 생성된 Google Cloud 프로젝트입니다.
  • TOPIC_ID시작하기 전에에서 만든 Cloud Pub/Sub 주제의 ID입니다.
projects/PROJECT_ID/topics/TOPIC_ID

예를 들어 프로젝트 이름이 my-project이고 주제 이름을 temperaturesensor로 지정했으면 다음을 입력합니다.

projects/my-project/topics/temperaturesensor.

Google Cloud 프로젝트에서 사용 가능한 모든 주제를 보려면 주제에서 주제 이름 열을 참조하세요.

구성 창에는 아래 표시된 것처럼 Pub/Sub 메시지 저장을 위해 트리거 출력 필드에 변수가 자동으로 입력됩니다.

트리거 출력 변수 이미지

데이터 매핑 태스크 구성

데이터 매핑 태스크를 구성하려면 다음 안내를 따르세요.

  1. 태스크/트리거 추가 > 태스크를 선택하여 사용 가능한 태스크 목록을 표시합니다.
  2. 데이터 매핑 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 데이터 매핑 태스크를 클릭하여 태스크의 구성 창을 엽니다.
  4. 데이터 매핑 편집기 열기를 클릭합니다.

    데이터 매핑 편집기를 사용하면 사용 가능한 변환 함수를 사용하여 원하는 출력 변수에 입력 변수를 매핑할 수 있습니다. 그러면 출력을 다른 통합 태스크 또는 트리거에 변수로 사용할 수 있습니다. 데이터를 변수로 전달하는 방법에 대한 자세한 내용은 Apigee Integration에서 변수 사용을 참조하세요.

    이 튜토리얼에서는 다음 단계에 따라 CloudPubSubMessage를 입력으로 사용하여 매핑을 만듭니다.

    1. 편집기 왼쪽에 있는 변수 목록에서 CloudPubSubMessage 칩을 첫 번째 입력 필드로 드래그합니다.
    2. CloudPubSubMessage 칩에서 + 함수 추가를 클릭하여 변수 함수의 드롭다운 목록을 표시합니다.
    3. TO_DOUBLE()을 클릭하여 CloudPubSubMessage JSON 값을 double 데이터 유형으로 변환합니다.
    4. +를 클릭하여 추가 매핑 함수를 연결합니다.
    5. 드롭다운 목록에서 SUBTRACT를 클릭하고 273.15의 매개변수를 입력하여 캘빈 온도를 섭씨 온도로 변환합니다.
    6. 출력 열의 첫 번째 필드를 클릭하여 변환된 데이터 값을 저장할 새 변수를 만듭니다. 다음 입력란을 작성하세요.
      • 이름: TemperatureInCelsius를 입력합니다.
      • 통합 출력으로 사용을 선택합니다.
      • 만들기를 클릭하여 변수를 만들고 창을 닫습니다. 새로운 섭씨 온도 변수가 데이터 매핑 편집기 왼쪽에 있는 변수 목록에 표시됩니다.
    7. 변수 목록에서 섭씨 온도 칩을 입력 열의 두 번째 필드로 드래그합니다.
    8. 섭씨 온도 칩에서 + 함수 추가를 클릭하여 사용 가능한 함수의 드롭다운 목록을 확인합니다.
    9. TO_STRING()을 클릭하여 변수의 데이터 유형을 double에서 string으로 변환합니다.
    10. 출력 열의 두 번째 필드를 클릭하여 변환된 데이터 값을 저장할 새 변수를 만듭니다. 다음 입력란을 작성하세요.
      • 이름: TemperatureInCelsiusString를 입력합니다.
      • 빈 기본값 의미...: 빈 문자열을 선택합니다.
      • 통합 출력으로 사용을 선택합니다.
      • 만들기를 클릭하여 변수를 만들고 창을 닫습니다. 새로운 변수가 데이터 매핑 편집기 왼쪽에 있는 변수 목록에 표시됩니다.
    11. 완료된 매핑은 아래 그림과 같이 표시됩니다.

      완료된 데이터 매핑 및 변수의 이미지

    12. 데이터 매핑 편집기에서 X를 클릭하여 매핑을 저장하고 편집기를 닫습니다.
  5. Cloud Pub/Sub 트리거 요소에서 제어 영역 위로 마우스 포인터를 가져간 후 줄을 클릭해서 데이터 매핑 태스크 요소의 제어 지점으로 드래그하여 Cloud Pub/Sub 트리거 요소에서 데이터 매핑 요소로 에지 연결을 추가합니다. 에지는 Cloud Pub/Sub 트리거 태스크에서 데이터 매핑 태스크로의 제어 흐름을 나타냅니다.

이메일 보내기 태스크 구성

이메일 보내기 태스크를 구성하려면 다음 안내를 따르세요.

  1. 통합 디자이너에서 태스크/트리거 추가 > 태스크를 선택하여 사용 가능한 태스크 목록을 표시합니다.

    이 단계에서는 이메일 보내기 태스크를 사용합니다.

  2. 이메일 보내기 요소를 통합 디자이너로 드래그합니다.
  3. 디자이너에서 이메일 보내기 요소를 클릭하여 태스크 구성 창을 엽니다. 다음 속성을 설정합니다.
    • 수신자: 이메일 주소를 입력합니다. 이 이메일을 사용하여 통합 완료를 확인합니다.
    • 제목: Temperature in Celsius를 입력합니다.
    • 이메일 본문: 데이터 매핑 태스크에서 이전에 생성된 TemperatureInCelsiusString 변수를 선택합니다.
    • 나머지 옵션은 기본 구성에서 남겨둘 수 있습니다.
    속성 변경사항은 자동으로 저장됩니다.
  4. 데이터 매핑 요소의 제어 지점에 마우스를 가져간 뒤 클릭한 다음 이메일 보내기 태스크 요소의 제어 지점으로 선을 드래그하여 데이터 매핑 요소에서 이메일 보내기 요소로 에지 연결을 추가합니다. 제어 지점과 에지 선이 노란색으로 변경됩니다. 에지는 데이터 매핑 태스크에서 이메일 보내기 태스크로의 제어 흐름을 나타냅니다.

    이 단계가 완료되면 통합이 완료되고 아래 그림에 표시된 것처럼 나타납니다.

    통합 트리거 및 태스크 이미지

통합 테스트

새 통합을 테스트하려면 다음 단계를 따르세요.

  1. 통합 디자이너 툴바에서 게시 버튼을 클릭합니다.
  2. Cloud Console에서 Pub/Sub 주제 페이지로 이동합니다.

    Pub/Sub 주제 페이지로 이동

  3. 이전 단계에서 만든 temperaturesensor 주제를 검색하고 선택합니다.
  4. 주제 세부정보 페이지에서 + 메시지 게시를 클릭하여 메시지 게시 구성 창을 엽니다.
  5. 메시지 본문 필드에서 307.15를 입력합니다. 이 메시지를 만드는 과정은 IOT 기기에서 Pub/Sub가 수신한 온도 값(캘빈)을 게시하는 과정을 시뮬레이션합니다.
  6. 게시를 클릭하여 주제에 메시지를 게시하고 통합을 트리거합니다.

성공적으로 완료했으면 통합이 캘빈에서 섭씨로 변환된 온도가 포함된 이메일을 이메일 보내기 태스크에 지정된 이메일 주소로 전송합니다. 이메일 클라이언트에서 이메일 수신 여부를 확인합니다.

통합에서 전송된 이메일에는 값 34가 포함된 메시지 본문이 포함됩니다.

이메일의 내용을 확인하는 것 외에도 로그를 검사하여 지정된 통합의 상태와 페이로드를 확인할 수 있습니다. 로그를 보려면 다음 안내를 따르세요.

  1. 통합 디자이너의 툴바에서 로그를 클릭합니다.
  2. 실행 로그 페이지에서 통합 실행 시도에 대한 세부정보를 볼 수 있습니다. 각 항목에는 다음을 포함하여 실행 시도에 대한 세부정보가 포함됩니다.
    • 통합 이름
    • 실행 ID
    • 상태
    • 시작 시간
    • 기간
    • 통합 ID
    • 트리거 ID
  3. 아래 그림에 표시된 것처럼 실행된 통합 옆의 확장 화살표(>)를 클릭하여 통합에 있는 태스크 및 변수의 확장된 목록과 태스크 상태 및 변수 페이로드를 확인합니다.

    통합 로그 이미지

수고하셨습니다. Apigee Integration 및 Cloud Pub/Sub 트리거로 통합을 성공적으로 구성하고 배포했습니다.

다음 단계