IBM Cloud Docs
Edge 함수 액션 및 트리거 사용

Edge 함수 액션 및 트리거 사용

엣지 함수는 액션과 트리거라는 두 가지 주요 구성 요소로 이루어져 있습니다. 액션은 엣지에서 실행할 로직을 정의하는 JavaScript 파일입니다. 트리거는 해당 작업이 언제, 어떤 상황에서 실행되어야 하는지를 정의하는 URL 기반의 라우팅 규칙입니다. 트리거는 특정 요청 패턴(예: 도메인 및 경로)을 적절한 작업으로 연결합니다. 관련 트리거가 없는 작업은 트래픽에 영향을 미치지 않습니다.

엣지 함수 작업

조치는 Javascript로 작성되며 이 조치에서 이벤트 리스너는 트리거 이벤트에 응답해야 합니다. 액션은 트리거에서 사용하지 않는 한 트래픽에 영향을 미치지 않습니다.

요금제 차이점

작업할 때의 차이점은 계획에 따라 다릅니다:

표준 요금제

  • 계정당 하나의 작업만 허용하며, 도메인의 이름을 따서 자동으로 명명됩니다(이름은 변경할 수 없음).
  • 작업을 업데이트하려면 새 JavaScript 파일을 업로드하거나 편집기에서 직접 코드를 편집합니다. 새 파일을 업로드하면 기존 작업이 대체됩니다.
  • JavaScript 파일을 업로드하면 파일 이름은 항상 내 도메인 이름으로 설정됩니다.

엔터프라이즈 요금제

  • 원하는 경우 각각 고유한 이름을 가진 스크립트를 무제한으로 업로드할 수 있습니다.
  • 작업을 만들 때 사용자 지정 이름을 지정할 수 있습니다.
  • JavaScript 파일을 업로드할 때 작업 이름은 파일 이름에서 가져옵니다.

액션에 대한 작업

트리거 이벤트에 대한 응답으로 실행되는 로직을 정의하는 작업을 생성, 업로드, 편집 및 관리할 수 있습니다. 콘솔은 각 핵심 작업에 대한 도구를 제공합니다:

  • 액션 만들기- 만들기를 클릭하여 기본 제공 코드 편집기를 사용하여 액션을 추가합니다. JavaScript 코드를 추가한 후 저장을 클릭하여 액션을 생성합니다.

  • 작업 읽기- 작업 표에서 기존 작업을 클릭하여 편집기에서 엽니다. 이렇게 하면 코드를 변경하지 않고도 코드를 볼 수 있습니다.

  • 작업 업데이트하기- 작업을 수정하려면 목록에서 해당 작업을 클릭하여 편집기에서 엽니다. 변경한 다음 저장을 클릭합니다. 변경 사항을 저장하면 업데이트된 작업이 업로드됩니다. 작업을 사용 중인 경우 업데이트가 즉시 적용됩니다.

  • 작업 업로드하기- 업로드를 클릭하여 JavaScript 파일을 업로드합니다. 기존 조치와 동일한 이름으로 조치를 업로드하거나 작성하면 기존 조치를 겹쳐쓰게 됩니다. 이 동작을 방지하려면 업로드하기 전에 작업 파일의 이름을 바꾸거나 생성 중에 고유한 이름을 입력하세요.

    업로드는 이름이 이미 존재하는지 여부에 따라 작업을 만들거나 업데이트하는 과정의 일부로 사용할 수도 있습니다.

  • 작업 삭제하기- 작업을 삭제하려면 선택한 작업의 표 행에서 삭제 아이콘 삭제 아이콘 클릭합니다. 트리거와 연결된 상태에서는 액션을 삭제할 수 없습니다. 액션을 삭제하려면 먼저 해당 액션을 사용하는 모든 트리거를 제거해야 합니다. 사용 열에는 각 작업에 연결된 트리거의 수가 표시됩니다.

  • 트리거 연결하기- 액션을 실행하려면 트리거가 필요합니다. 트리거 탭에서 트리거를 추가하고 기존 작업 목록에서 작업을 선택합니다. 작업 테이블의 사용 열에는 현재 각 작업에 연결된 트리거의 수가 표시됩니다.

엣지 기능 트리거

트리거(라우트)는 도메인 트래픽이 작업으로 라우팅되는 방식을 결정합니다. 계정의 도메인을 기반으로 URL 패턴을 미리 정의된 작업과 연결합니다. URL 패턴은 도메인을 포함해야 하며 도메인 접두사 또는 경로 끝에 와일드카드를 포함할 수 있습니다. 경로를 지정하지 않으면 / 이 암시적으로 추가됩니다. URL 패턴에는 접두사 와일드카드나 쿼리 매개 변수를 포함할 수 없습니다.

요금제 차이점

트리거가 작동하는 방식은 요금제 간에 차이가 없습니다. 모든 요금제는 트리거 추가, 편집, 삭제를 지원합니다.

트리거 작업

트리거를 추가하기 전에 도메인을 추가해야 합니다. 트리거는 트래픽이 엣지 함수 액션으로 라우팅되는 방식을 정의합니다. 트리거는 URL 패턴을 기존 작업과 연결합니다.

트리거는 아직 액션이 없는 경우에도 만들 수 있지만, 액션이 선택될 때까지 로직을 호출하지 않습니다.

  • 트리거 추가 하기 - 트리거 탭으로 이동하여 트리거 추가를 클릭합니다. URL 패턴을 입력한 다음 기존 작업 목록에서 이 패턴과 연결할 작업을 선택합니다. 이렇게 하면 경로와 작업 간의 연결이 설정됩니다.

    엣지 함수를 실행하지 않고 트리거 경로를 활성 상태로 유지하려면 엣지 함수 회피를 활성화합니다. 예를 들어 my-functiongamma.cistest-load.com/* 에 할당되었지만 gamma.cistest-load.com/data 이 이를 우회하도록 하려면 /data 에 대한 별도의 트리거를 생성하고 에지 회피 기능을 사용하도록 설정합니다. 이렇게 하면 my-function 을 호출하지 않고도 /data 경로가 활성 상태로 유지됩니다.

  • 트리거 편집 하기 - 수정하려는 트리거의 표 행에서 편집 아이콘 편집 아이콘 클릭한 다음 변경하고 저장을 클릭합니다.

  • 트리거 삭제 하기 - 수정하려는 트리거의 표 행에서 삭제 아이콘 삭제 아이콘 클릭합니다. 이 조치는 실행 취소할 수 없습니다. 트리거를 삭제하면 경로와 액션 간의 연결이 제거됩니다.