아티팩트 구성하기
다음 세 단계에 따라 W&B 아티팩트를 구성하세요.wandb.Artifact()로 아티팩트 Python 객체 생성하기
wandb.Artifact() 클래스를 초기화하여 아티팩트 객체를 생성하세요. 다음 매개변수를 지정하세요.
- Name: 아티팩트의 이름입니다. 이름은 고유하고, 내용을 잘 나타내며, 기억하기 쉬워야 합니다.
- Type: 아티팩트의 유형입니다. 유형은 단순하고 내용을 잘 나타내야 하며, 머신러닝 파이프라인의 한 단계에 대응해야 합니다. 일반적인 아티팩트 유형으로는
'dataset','model'등이 있습니다.
W&B는 사용자가 지정한 “name”과 “type”을 사용하여 W&B App에 방향성 비순환 그래프(DAG)를 생성합니다. 자세한 내용은 아티팩트 그래프 탐색 및 순회를 참조하세요.
"artifact-name" 및 "artifact-type" 자리 표시자는 실제 값으로 바꾸세요.
아티팩트는 유형이 다르더라도 같은 이름을 사용할 수 없습니다. 예를 들어, 유형이
dataset인 cats 아티팩트를 만든 후에는 유형이 model인 cats 아티팩트를 또 만들 수 없습니다.기본 다이제스트 알고리즘은 여전히 MD5입니다. W&B Python SDK 0.29.0 이상에서는
digest_algorithm="XXH128"을 설정하면 새 아티팩트에 더 빠른 해싱을 적용할 수 있습니다. MD5를 사용하는 기존 아티팩트 컬렉션은 계속 MD5를 사용합니다. 0.29.0 이전 버전의 SDK에서는 Artifact.verify()로 XXH128 항목이 포함된 아티팩트를 검증할 수 없습니다.wandb.Artifact 클래스 정의를 참조하세요.
아티팩트에 하나 이상의 파일 추가하기
아티팩트 객체에 파일, 디렉터리, 외부 URI 참조(예: Amazon S3) 등을 추가할 수 있습니다. 단일 파일을 추가하려면 아티팩트 객체의Artifact.add_file() 메서드를 사용하세요.
Artifact.add_dir() 메서드를 사용하세요.
아티팩트를 W&B 서버에 저장하기
아티팩트를 W&B 서버에 저장하세요. 아티팩트를 저장하려면 run 객체의wandb.Run.log_artifact() 메서드를 사용하세요.
아티팩트에 파일 추가
다음 섹션에서는 다양한 유형의 객체를 아티팩트에 추가하는 방법을 설명합니다. 예시에서는 다음과 같은 구조의 디렉터리가 있다고 가정합니다.단일 파일 추가
wandb.Artifact.add_file()을 사용하면 로컬 파일 하나를 아티팩트에 추가할 수 있습니다. 파일의 로컬 경로를 local_path 매개변수에 지정하세요.
'hello.txt'라는 파일이 있다고 가정해 보겠습니다.
name 매개변수에 다른 이름을 전달하면 아티팩트 객체 안에서 파일 이름을 변경할 수 있습니다. 앞의 예시를 이어서 보면 다음과 같습니다.
여러 파일 추가
wandb.Artifact.add_dir() 메서드를 사용하면 로컬 디렉터리에 있는 여러 파일을 아티팩트에 추가할 수 있습니다. local_path 매개변수에 디렉터리의 로컬 경로를 지정하세요.
URI 참조 추가
URI의 스킴을 W&B 라이브러리가 지원하면 아티팩트는 재현성을 위해 체크섬 및 기타 정보를 추적합니다.wandb.Artifact.add_reference() 메서드를 사용하여 아티팩트에 외부 URI 참조를 추가하세요. 'uri' 문자열은 사용할 URI로 바꾸세요. 필요하면 name 매개변수에 아티팩트 내에서 사용할 경로를 전달할 수도 있습니다.
http(s)://: HTTP로 액세스할 수 있는 파일의 경로입니다. HTTP 서버가ETag및Content-Length응답 헤더를 지원하면 아티팩트는 etag 형식의 체크섬과 크기 메타데이터를 추적합니다.s3://: S3에 있는 객체 또는 객체 접두사의 경로입니다. 아티팩트는 참조된 객체의 체크섬과 버전 관리 정보(버킷에 객체 버전 관리가 활성화된 경우)를 추적합니다. 객체 접두사를 지정하면 해당 접두사 아래의 객체가 최대 10,000개까지 포함됩니다.gs://: GCS에 있는 객체 또는 객체 접두사의 경로입니다. 아티팩트는 참조된 객체의 체크섬과 버전 관리 정보(버킷에 객체 버전 관리가 활성화된 경우)를 추적합니다. 객체 접두사를 지정하면 해당 접두사 아래의 객체가 최대 10,000개까지 포함됩니다.
병렬 run에서 아티팩트에 파일 추가하기
대규모 데이터셋이나 분산 트레이닝에서는 여러 병렬 run이 하나의 아티팩트에 함께 기여해야 할 수 있습니다.로깅된 아티팩트 및 기타 메타데이터의 경로 찾기
다음 코드 스니펫은 W&B Public API를 사용하여 run에 포함된 파일 목록을 이름 및 URL과 함께 조회하는 방법을 보여줍니다.<entity/project/run-id> 플레이스홀더를 실제 값으로 바꾸세요.