함수의 Marketplace 배포와 설치 계약

Foundry DevOps 제품에 함수 출력을 추가하고 함수 및 버전을 선택하면 다른 환경에 설치하여 사용할 수 있습니다.

코드와 모델의 의존성

코드 저장소에서 만든 함수를 패키징하면 기반 저장소가 제품의 추가 출력으로 자동 포함됩니다. 소스 코드를 함께 패키징할지는 별도로 선택합니다. 실행에 소스 코드가 반드시 필요한 것은 아니므로 Bootstrap 설치가 목적이 아니라면 소스 포함은 일반적으로 권장하지 않습니다. 소스를 포함해도 설치 직후 컴파일이나 빌드가 가능한 상태라는 보장은 없습니다.

설치 후 수정은 원본 함수에서 변경하고 제품의 새 버전을 게시한 뒤 설치본을 업그레이드하는 방식이 권장됩니다. 원본을 소유하지 않은 경우 제품 관리자에게 수정 요청을 전달합니다.

모델의 기본 브랜치에서 직접 배포한 모델 함수는 모델 버전과 라이브 배포를 의존성으로 포함합니다. 모델 패키징에서 Package live deployment를 Yes로 선택해 자동 포함할 수도 있습니다. 설치 환경의 모델과 배포를 사용하며 추론 요청 전에 배포가 실행 중이어야 합니다. 모델 제품의 설치에서 버전과 시작 조건을 확인합니다.

확장 실행 기능이 있는 함수는 Functions settings의 대상 프로젝트 허용 목록을 충족해야 설치할 수 있습니다.

Deduplication mode

기본 모드에서는 최초 설치 함수 버전을 0.1.0으로 게시합니다. 이후 업그레이드에서는 설치된 함수의 최신 버전에서 Minor를 증가시킵니다. 예를 들어 최신이 1.1.0이면 다음 설치는 1.2.0입니다. 원본 패키지의 버전을 그대로 재현하는 방식이 아닙니다.

API 이름은 온톨로지마다 고유해야 합니다. myFunction이 이미 사용 중이면 myFunction1, 그 이름도 사용 중이면 myFunction2처럼 숫자를 붙입니다. 설치된 함수에 이름이 정해진 뒤에는 이후 업그레이드에서도 그 이름을 유지합니다.

함수 버전은 불변이므로 이미 게시한 같은 버전에 내용을 덮어쓰지 않습니다.

Stable mode, Beta

Stable mode는 원본 버전과 API 이름을 보존하는 Beta 기능이며 플랫폼 인스턴스에 제공되지 않을 수 있습니다. 필요한 경우 Palantir Support에 활성화를 요청합니다. 자체 버전 체계가 있는 Compute module 함수는 이 모드를 지원하지 않습니다.

버전 충돌로 새 함수가 생기면 같은 설치본의 소비 앱은 새 참조로 자동 갱신합니다. 설치본 밖의 앱은 수동으로 참조를 변경해야 합니다.

실행 모드와 배포 구성

실행 모드는 저장소별로 패키징하며 같은 배포를 쓰는 여러 함수에 한 번 적용합니다. 전용 배포에서는 환경변수, 자원 요청과 한도, 확장 한도 등 설정을 포함합니다. 컨테이너 이미지를 고정 값으로 담는 대신 설치하는 함수 버전에서 이미지를 결정합니다.

전용 배포 함수를 패키징하려면 해당 저장소의 배포가 존재하고 패키징할 함수 버전을 실행 중이어야 합니다. 다르면 패키징이 실패하므로 배포를 시작하거나 갱신하거나 서버리스로 전환해야 합니다.

마지막 경우에는 소스가 서버리스였더라도 대상의 장기 실행 배포에 계속 컴퓨팅 비용이 발생합니다.

전용 배포 업그레이드의 영향

한 번에 버전 하나만 실행할 수 있으므로 업그레이드하면 새 버전이 기존 배포 버전을 대체합니다. 같은 제품이나 연결 제품에 속하지 않은 외부 소비자는 자동 갱신되지 않습니다. 그 소비자가 이전 버전을 고정 참조하면 실행할 수 없어 오류가 발생합니다.

소비 앱을 같은 제품이나 연결 제품에 포함하여 함께 올리거나, 여러 버전을 필요할 때 실행할 수 있는 서버리스를 사용하는 방식이 권장됩니다. 소스 구성처럼 실행 중 적용할 수 없는 변경은 업그레이드 중 배포를 중지하고 다시 시작할 수 있어 중단 시간이 발생할 수 있습니다.

TSv1의 정적 함수 입력

TSv1은 Static 데코레이터로 설치자가 교체할 함수 로직을 지정할 수 있습니다. 다음 예제의 기본 동작은 실제 입력의 부호를 바꾸며, 설치자가 같은 입력과 반환 계약의 함수를 제공하면 그 로직을 사용합니다.

import { Function, Static, Double } from "@foundry/functions-api";

export class MyFunctions {
    @Function()
    public async modifyNumberByStaticFoo(
        n: Double,
        @Static() staticFunctionInput: (num: Double) => Promise<Double> = this.defaultFoo
    ): Promise<Double> {
        return staticFunctionInput(n);
    }

    private async defaultFoo(n: Double): Promise<Double> {
        return -n;
    }
}

클래스를 함수 프로젝트의 index.ts에서 내보내야 합니다. 정적 입력은 제품 설치의 함수 입력으로 나타납니다. 교체한 정적 함수 안에서 쿼리 함수나 외부 API를 호출하는 기능은 지원하지 않습니다.

사용자 지정 별칭과 모델 별칭

TSv2와 Python의 Custom aliases는 구성, 기능 플래그나 환경별 설정의 문자열 값입니다. 제품에 자동으로 Inputs로 나타나며 설명과 사전 설정 값을 제공할 수 있습니다. 함수 로직 자체를 교체하는 TSv1 Static 입력과 다릅니다.

Model aliases는 설치 시 다시 매핑할 수 없습니다. 실행 시 원본 저장소에 지정한 정확한 모델 RID를 해소하므로 모든 대상 환경에 해당 모델이 있어야 합니다. 모델이 없으면 별칭 해소가 실행 중 실패합니다.

인터페이스 입력 오류

인터페이스를 입력으로 받는 함수가 대상에서 MarketplaceSdkObjectMappingNotFound를 발생시킬 수 있습니다. SDK에 인터페이스만 있고 실제 구현 객체 유형의 매핑이 없을 때의 오류입니다.

대상에서 사용할 구체 객체 유형이 원본 환경에도 있어야 하며, 그 유형을 패키징하는 SDK에 명시적으로 포함해야 매핑을 생성할 수 있습니다.