

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 구성 파일
<a name="train-remote-decorator-config"></a>

Amazon SageMaker Python SDK는 AWS 인프라 기본 유형에 대한 기본값 설정을 지원합니다. 관리자가 이러한 기본값을 구성하면 지원되는 API를 호출할 때 SageMaker Python SDK가 이를 자동으로 전달합니다. 데코레이터 함수의 인수는 구성 파일 내에 넣을 수 있습니다. 이를 통해 인프라와 관련된 설정을 코드 베이스에서 분리할 수 있습니다. 원격 함수 및 메서드의 파라미터와 인수에 대한 자세한 내용은 [원격 함수 클래스 및 메서드 사양](https://sagemaker.readthedocs.io/en/stable/remote_function/sagemaker.remote_function.html)을 참조하세요.

네트워크 구성, IAM 역할, 입력용 Amazon S3 폴더, 출력 데이터 및 구성 파일 내 태그에 대한 인프라 설정을 수행할 수 있습니다. @remote 데코레이터 또는 `RemoteExecutor` API를 사용하여 함수를 호출할 때 구성 파일을 사용할 수 있습니다.

다음은 종속성, 리소스 및 기타 인수를 정의하는 예제 구성 파일입니다. 이 예제 구성 파일은 @remote 데코레이터 또는 RemoteExecutor API를 사용하여 시작된 함수를 호출하는 데 사용됩니다.

```
SchemaVersion: '1.0'
SageMaker:
  PythonSDK:
    Modules:
      RemoteFunction:
        Dependencies: 'path/to/requirements.txt'
        EnableInterContainerTrafficEncryption: true
        EnvironmentVariables: {'EnvVarKey': 'EnvVarValue'}
        ImageUri: '366666666666.dkr.ecr.us-west-2.amazonaws.com/my-image:latest'
        IncludeLocalWorkDir: true
        CustomFileFilter: 
          IgnoreNamePatterns:
          - "*.ipynb"
          - "data"
        InstanceType: 'ml.m5.large'
        JobCondaEnvironment: 'your_conda_env'
        PreExecutionCommands:
            - 'command_1'
            - 'command_2'
        PreExecutionScript: 'path/to/script.sh'
        RoleArn: 'arn:aws:iam::366666666666:role/MyRole'
        S3KmsKeyId: 'yourkmskeyid'
        S3RootUri: 's3://amzn-s3-demo-bucket/my-project'
        VpcConfig:
            SecurityGroupIds: 
            - 'sg123'
            Subnets: 
            - 'subnet-1234'
        Tags: [{'Key': 'yourTagKey', 'Value':'yourTagValue'}]
        VolumeKmsKeyId: 'yourkmskeyid'
```

@remote 데코레이터 및 `RemoteExecutor`가 다음 구성 파일에서 `Dependencies`을 검색합니다.
+ 관리자 정의 구성 파일.
+ 사용자 정의 구성 파일.

이러한 구성 파일의 기본 위치는 환경에 따라 다르고 환경과 관련이 있습니다. 다음 코드 예제에서는 관리자 및 사용자 구성 파일의 기본 위치를 반환합니다. 이러한 명령은 SageMaker Python SDK를 사용하는 것과 동일한 환경에서 실행해야 합니다.

```
import os
from platformdirs import site_config_dir, user_config_dir

#Prints the location of the admin config file
print(os.path.join(site_config_dir("sagemaker"), "config.yaml"))

#Prints the location of the user config file
print(os.path.join(user_config_dir("sagemaker"), "config.yaml"))
```

관리자 정의 구성 파일 및 사용자 정의 구성 파일 경로에 각각 `SAGEMAKER_ADMIN_CONFIG_OVERRIDE` 및 `SAGEMAKER_USER_CONFIG_OVERRIDE` 환경 변수를 설정하여 이러한 파일의 기본 위치를 재정의할 수 있습니다.

관리자 정의 구성 파일 및 사용자 정의 구성 파일 모두에 키가 있는 경우 사용자 정의 파일의 값이 사용됩니다.