소스 파일을 레시피로 패키징
이 튜토리얼에서는 제공된 소매 판매 샘플 원본 파일을 보관 파일로 패키지하는 방법에 대한 지침을 제공하며, 이 파일은 UI 또는 API를 사용하여 레서피 가져오기 작업 과정 따라 Adobe Experience Platform Data Science Workspace 에서 레서피 만드는 데 사용할 수 있습니다.
이해해야 할 개념:
- 레시피: 레서피는 모델 사양에 대한 Adobe Systems 용어로, 특정 기계 학습, 인공 인텔리전스 알고리즘 또는 알고리즘 앙상블, 처리 논리 및 학습된 모델을 빌드 및 실행하여 특정 비즈니스 문제를 해결하는 데 필요한 구성을 나타내는 최상위 컨테이너입니다.
- 소스 파일: 레서피 로직을 포함하는 프로젝트의 개별 파일입니다.
전제 조건
레시피 만들기
레시피 생성은 아카이브 파일을 빌드 소스 파일을 패키징하는 것으로 시작됩니다. 소스 파일은 당면한 특정 문제 문제를 해결하는 데 사용되는 기계 학습 논리 및 알고리즘을 정의하며 , R, PySpark 또는 Scala로 Python작성됩니다. 빌드된 아카이브 파일은 Docker 이미지 형식을 취합니다. 빌드가 완료되면 패키지된 아카이브 파일을 UI🔗 또는 API를 사용하여 레서피 생성하기 위해 가져옵니다Data Science Workspace.
Docker 기반 모델 작성 docker-based-model-authoring
Docker 이미지를 사용하면 개발자가 필요한 모든 부분(예: 라이브러리 및 기타 종속성)으로 애플리케이션 패키지를 패키지화하여 하나의 패키지로 제공할 수 있습니다.
빌드된 도커 이미지는 레시피 만들기 워크플로 중에 제공된 자격 증명을 사용하여 Azure Container Registry에 푸시됩니다.
Azure Container Registry 자격 증명을 얻으려면 Adobe Experience Platform에 로그인하십시오. 왼쪽 탐색 열에서 워크플로(으)로 이동합니다. 레시피 가져오기 를 선택한 후 시작 을 선택하십시오. 참조를 위해 아래 스크린 샷을 참조하십시오.
구성 페이지 가 열립니다. 적절한 레서피 이름(예: "소매 판매 레서피")을 제공하고 선택적으로 설명 또는 설명서 URL을 제공합니다. 완료되면 다음(Next)을 클릭합니다.
적절한 런타임 을 선택한 다음 유형 에 대한 분류 을(를) 선택하십시오. 완료되면 Azure 컨테이너 레지스트리 자격 증명이 생성됩니다.
- Python 레시피의 경우 Python 런타임을 선택하십시오.
- R 레시피의 경우 R 런타임을 선택하십시오.
- PySpark 레시피의 경우 PySpark 런타임을 선택하십시오. 아티팩트 유형이 자동으로 채워집니다.
- Scala 레시피의 경우 Spark 런타임을 선택합니다. 아티팩트 유형이 자동으로 채워집니다.
Docker 호스트, username 및 암호에 대한 값을 기록해 둡니다. 이러한 워크플로우는 아래 설명된 워크플로우에서 이미지를 빌드하고 푸시 Docker 하는 데 사용됩니다.
소스 파일 패키징
시작 Experience Platform Data Science 작업 영역 Reference 저장소에 있는 샘플 코드베이스를 가져옵니다.
Docker 이미지 빌드 Python python-docker
아직 복제하지 않은 경우 다음 명령을 사용하여 로컬 시스템에 저장소 복제 GitHub 를 수행합니다.
git clone https://github.com/adobe/experience-platform-dsw-reference.git
디렉토리 experience-platform-dsw-reference/recipes/python/retail로 이동합니다. 여기에서 스크립트를 login.sh 찾을 수 있으며 build.sh Docker에 로그인하고 이미지를 빌드 Python Docker 하는 데 사용됩니다. Docker 자격 증명🔗이 준비되었으면 다음 명령을 순서대로 입력합니다.
# for logging in to Docker
./login.sh
# for building Docker image
./build.sh
로그인 스크립트를 실행할 때 Docker 호스트, 사용자 이름 및 암호를 제공해야 합니다. 빌드할 때 빌드에 대한 Docker 호스트 및 버전 태그를 제공해야 합니다.
빌드 스크립트가 완료되면 콘솔 출력에 Docker 소스 파일 URL이 제공됩니다. 이 특정 예제의 경우 다음과 같이 표시됩니다좋아요.
# URL format:
{DOCKER_HOST}/ml-retailsales-python:{VERSION_TAG}
이 URL을 복사하고 다음 단계로🔗 이동합니다.
R Docker 이미지 빌드 r-docker
아직 복제하지 않은 경우 다음 명령을 사용하여 로컬 시스템에 저장소 복제 GitHub 를 수행합니다.
git clone https://github.com/adobe/experience-platform-dsw-reference.git
복제된 저장소 내의 디렉토리 experience-platform-dsw-reference/recipes/R/Retail - GradientBoosting 로 이동합니다. 여기에서 Docker에 로그인 하고 R Docker 이미지를 빌드 하는 데 사용할 파일과 login.sh build.sh 파일을 찾을 수 있습니다. Docker 자격 증명🔗이 준비되었으면 다음 명령을 순서대로 입력합니다.
# for logging in to Docker
./login.sh
# for build Docker image
./build.sh
로그인 스크립트를 실행할 때 Docker 호스트, 사용자 이름 및 암호를 제공해야 합니다. 빌드할 때 빌드에 대한 Docker 호스트 및 버전 태그를 제공해야 합니다.
빌드 스크립트가 완료되면 콘솔 출력에 Docker 소스 파일 URL이 제공됩니다. 이 특정 예제의 경우 다음과 같이 표시됩니다좋아요.
# URL format:
{DOCKER_HOST}/ml-retail-r:{VERSION_TAG}
이 URL을 복사하고 다음 단계(으)로 이동합니다.
PySpark Docker 이미지 작성 pyspark-docker
다음 명령을 사용하여 로컬 시스템에 저장소를 GitHub 복제하여 시작 하십시오.
git clone https://github.com/adobe/experience-platform-dsw-reference.git
디렉토리 experience-platform-dsw-reference/recipes/pyspark/retail로 이동합니다. 스크립트 login.sh build.sh 는 여기에 있으며 Docker에 로그인 하고 Docker 이미지를 빌드 하는 데 사용됩니다. Docker 자격 증명🔗이 준비되었으면 다음 명령을 순서대로 입력합니다.
# for logging in to Docker
./login.sh
# for building Docker image
./build.sh
로그인 스크립트를 실행할 때 Docker 호스트, 사용자 이름 및 암호를 제공해야 합니다. 빌드 시 빌드에 도커 호스트 및 버전 태그를 제공해야 합니다.
빌드 스크립트가 완료되면 콘솔 출력에 도커 소스 파일 URL이 제공됩니다. 이 특정 예제의 경우 다음과 같습니다.
# URL format:
{DOCKER_HOST}/ml-retailsales-pyspark:{VERSION_TAG}
이 URL을 복사하고 다음 단계(으)로 이동합니다.
Scala Docker 이미지 빌드 scala-docker
터미널에서 다음 명령을 사용하여 GitHub 리포지토리를 로컬 시스템에 복제합니다.
git clone https://github.com/adobe/experience-platform-dsw-reference.git
다음, 스크립트를 login.sh 찾을 수 있는 디렉토리 experience-platform-dsw-reference/recipes/scala 로 이동하고 build.sh. 이러한 스크립트는 Docker에 로그인 하고 Docker 이미지를 빌드 하는 데 사용됩니다. Docker 자격 증명🔗이 준비되었으면 터미널에 다음 명령을 순서대로 입력합니다.
# for logging in to Docker
./login.sh
# for building Docker image
./build.sh
login.sh Docker에 로그인하려고 할 때 권한 오류가 발생하면 명령을 bash login.sh사용해 보십시오.로그인 스크립트를 실행할 때 Docker 호스트, 사용자 이름 및 암호를 제공해야 합니다. 빌드할 때 빌드에 대한 Docker 호스트 및 버전 태그를 제공해야 합니다.
빌드 스크립트가 완료되면 콘솔 출력에 Docker 소스 파일 URL이 제공됩니다. 이 특정 예제의 경우 다음과 같이 표시됩니다좋아요.
# URL format:
{DOCKER_HOST}/ml-retailsales-spark:{VERSION_TAG}
이 URL을 복사하고 다음 단계로🔗 이동합니다.
다음 단계 next-steps
이 튜토리얼에서는 Recipe Data Science Workspace를 로 가져오기 위한 전제 조건 단계인 Recipe로 소스 파일을 패키징하는 방법에 대해 설명했습니다. 이제 해당 이미지 URL와 함께 Azure Container Registry에 Docker 이미지가 있어야 합니다. 이제 패키지된 레서피 Data Science Workspace가져오기에 대한 튜토리얼을 시작할 준비가 되었습니다. 시작하려면 아래 튜토리얼 링크 중 하나를 선택하십시오.