> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.
> W&B 아티팩트에 TTL(수명) 정책을 설정하여 자동 삭제를 예약하고 저장소 사용량을 관리하세요.
# 아티팩트 데이터 보존 관리
export const ColabLink = ({url}) =>
Try in Colab
;
W\&B 아티팩트 수명(TTL) 정책으로 W\&B에서 아티팩트를 삭제할 시점을 예약하세요. 아티팩트를 삭제하면 W\&B는 해당 아티팩트를 *소프트 삭제* 상태로 표시합니다. 즉, 아티팩트는 삭제 대상으로 표시되지만 파일은 저장소에서 즉시 삭제되지 않습니다. W\&B의 아티팩트 삭제 방식에 대한 자세한 내용은 [아티팩트 삭제](/ko/products/wandb/artifacts/delete-artifacts) 페이지를 참조하세요.
W\&B 앱에서 아티팩트 TTL로 데이터 보존을 관리하는 방법을 알아보려면 [아티팩트 TTL로 데이터 보존 관리하기](https://www.youtube.com/watch?v=hQ9J6BoVmnc) 비디오 튜토리얼을 시청하세요.
* 팀 관리자만 [팀 설정](/ko/products/wandb/platform/app/settings-page/teams)을 확인하고 (1) TTL 정책을 설정하거나 편집할 수 있는 사용자 지정 또는 (2) 팀 기본 TTL 설정과 같은 팀 수준 TTL 설정에 액세스할 수 있습니다.
* W\&B 앱 UI의 아티팩트 세부 정보에서 TTL 정책을 설정하거나 편집하는 옵션이 표시되지 않거나, 프로그래밍 방식으로 TTL을 설정해도 아티팩트의 TTL 속성이 변경되지 않는다면 팀 관리자가 해당 권한을 부여하지 않은 것입니다.
자동 생성된 아티팩트
사용자가 생성한 아티팩트에만 TTL 정책을 사용할 수 있습니다. W\&B가 자동 생성한 아티팩트에는 TTL 정책을 설정할 수 없습니다.
다음 아티팩트 유형은 자동 생성된 아티팩트를 나타냅니다:
* `run_table`
* `code`
* `job`
* `wandb-*`로 시작하는 모든 아티팩트 유형
[W\&B 플랫폼](/ko/products/wandb/artifacts/explore-and-traverse-an-artifact-graph)에서 또는 프로그래밍 방식으로 아티팩트의 유형을 확인할 수 있습니다:
```python theme={"system"}
import wandb
with wandb.init(project="") as run:
artifact = run.use_artifact(artifact_or_name="")
print(artifact.type)
```
`<>`로 둘러싸인 값을 자신의 값으로 바꾸세요.
TTL 정책을 편집하고 설정할 수 있는 사용자 지정
팀 내에서 TTL 정책을 설정하고 편집할 수 있는 사용자를 지정합니다. TTL 권한을 팀 관리자에게만 부여하거나, 팀 관리자와 팀 구성원 모두에게 부여할 수 있습니다.
TTL 정책을 설정하거나 편집할 수 있는 사용자는 팀 관리자만 지정할 수 있습니다.
1. 팀의 프로필 페이지로 이동하세요.
2. **Settings** 탭을 선택하세요.
3. **Artifacts time-to-live (TTL) section**으로 이동하세요.
4. **TTL permissions dropdown**에서 TTL 정책을 설정하고 편집할 수 있는 사용자를 선택하세요.
5. **Review and save settings**를 클릭하세요.
6. 변경 사항을 확인하고 **Save settings**를 선택하세요.
TTL 정책 생성
아티팩트를 생성할 때 또는 생성 후에 소급하여 TTL 정책을 설정할 수 있습니다.
아래의 모든 코드 스니펫에서 `<>`로 감싼 내용을 사용자의 정보로 바꾸세요.
아티팩트 생성 시 TTL 정책 설정
W\&B Python SDK를 사용하여 아티팩트 생성 시 TTL 정책을 정의하세요. TTL 정책은 일반적으로 일 단위로 정의됩니다.
아티팩트 생성 시 TTL 정책을 정의하는 것은 일반적으로 [아티팩트 생성](/ko/products/wandb/artifacts/construct-an-artifact)하는 방법과 유사합니다. 단, 아티팩트의 `ttl` 속성에 시간 델타를 전달한다는 점이 다릅니다.
다음 단계에 따라 진행하세요:
1. [아티팩트 생성](/ko/products/wandb/artifacts/construct-an-artifact).
2. 파일, 디렉터리 또는 레퍼런스와 같은 [아티팩트에 콘텐츠 추가](/ko/products/wandb/artifacts/construct-an-artifact#add-files-to-an-artifact).
3. Python의 표준 라이브러리의 일부인 [`datetime.timedelta`](https://docs.python.org/3/library/datetime.html) 데이터 유형으로 TTL 시간 제한을 정의하세요.
4. [아티팩트 로깅](/ko/products/wandb/artifacts/construct-an-artifact#3-save-your-artifact-to-the-wb-server).
다음 코드 스니펫은 아티팩트를 생성하고 TTL 정책을 설정하는 방법을 보여줍니다.
```python theme={"system"}
import wandb
from datetime import timedelta
with wandb.init(project="", entity="") as run:
artifact = wandb.Artifact(name="", type="")
artifact.add_file("")
artifact.ttl = timedelta(days=30) # TTL 정책 설정
run.log_artifact(artifact)
```
이전 코드 스니펫은 아티팩트의 TTL 정책을 30일로 설정합니다. 즉, W\&B는 30일 후에 아티팩트를 삭제합니다.
아티팩트를 생성한 후 TTL 정책 설정 또는 편집하기
W\&B App UI 또는 W\&B Python SDK를 사용하여 기존 아티팩트에 TTL 정책을 정의하세요.
아티팩트의 TTL을 수정하더라도 아티팩트의 만료 시점은 여전히 아티팩트의 `createdAt` 타임스탬프를 기준으로 계산됩니다.
1. [아티팩트를 가져옵니다](/ko/products/wandb/artifacts/download-and-use-an-artifact).
2. 아티팩트의 `ttl` 속성에 시간 델타 값을 전달합니다.
3. [`save`](/ko/products/wandb/ref/python/experiments/run#save) 메서드로 아티팩트를 업데이트합니다.
다음 코드 스니펫은 아티팩트에 TTL 정책을 설정하는 방법을 보여줍니다.
```python theme={"system"}
import wandb
from datetime import timedelta
artifact = run.use_artifact("")
artifact.ttl = timedelta(days=365 * 2) # 2년 후 삭제
artifact.save()
```
위 코드 예시는 TTL 정책을 2년으로 설정합니다.
1. W\&B App UI에서 W\&B 프로젝트로 이동하세요.
2. 프로젝트 사이드바에서 아티팩트 아이콘을 선택하세요.
3. 아티팩트 목록에서 아티팩트 유형을 펼치세요
4. TTL 정책을 편집할 아티팩트 버전을 선택하세요.
5. **Version** 탭을 클릭하세요.
6. 드롭다운에서 **TTL 정책 편집**을 선택하세요.
7. 표시되는 모달의 TTL 정책 드롭다운에서 **Custom**을 선택하세요.
8. **TTL duration** 필드에 TTL 정책을 일 단위로 입력하세요.
9. **TTL 업데이트** 버튼을 선택하여 변경 사항을 저장하세요.
팀의 기본 TTL 정책 설정하기
팀 관리자만 팀의 기본 TTL 정책을 설정할 수 있습니다.
팀의 기본 TTL 정책을 설정하세요. 기본 TTL 정책은 기존 아티팩트와 앞으로 생성될 모든 아티팩트에 각 아티팩트의 생성 날짜를 기준으로 적용됩니다. 버전 수준의 TTL 정책이 이미 설정된 아티팩트는 팀의 기본 TTL의 영향을 받지 않습니다.
1. 팀의 프로필 페이지로 이동하세요.
2. **Settings** 탭을 선택하세요.
3. **Artifacts time-to-live (TTL) section**으로 이동하세요.
4. **Set team's default TTL policy**를 클릭하세요.
5. **Duration** 필드에서 TTL 정책을 일 단위로 설정하세요.
6. **Review and save settings**를 클릭하세요.
7/ 변경 사항을 확인한 다음 **Save settings**를 선택하세요.
run 외부에서 TTL 정책 설정
Public API를 사용하여 run을 가져오지 않고 아티팩트를 검색한 다음 TTL 정책을 설정하세요. TTL 정책은 일반적으로 일 단위로 정의됩니다.
다음 코드 샘플은 Public API를 사용하여 아티팩트를 가져오고 TTL 정책을 설정하는 방법을 보여줍니다.
```python theme={"system"}
api = wandb.Api()
artifact = api.artifact("entity/project/artifact:alias")
artifact.ttl = timedelta(days=365) # 1년 후 삭제
artifact.save()
```
TTL 정책 비활성화
W\&B Python SDK 또는 W\&B App UI를 사용하여 특정 아티팩트 버전에 대한 TTL 정책을 비활성화하세요.
1. [아티팩트를 가져오세요](/ko/products/wandb/artifacts/download-and-use-an-artifact).
2. 아티팩트의 `ttl` 속성을 `None`으로 설정하세요.
3. [`save`](/ko/products/wandb/ref/python/experiments/run#save) 메서드로 아티팩트를 업데이트하세요.
다음 코드 스니펫은 아티팩트의 TTL 정책을 끄는 방법을 보여줍니다:
```python theme={"system"}
artifact = run.use_artifact("")
artifact.ttl = None
artifact.save()
```
1. W\&B App UI에서 W\&B 프로젝트로 이동하세요.
2. 프로젝트 사이드바에서 아티팩트 아이콘을 선택하세요.
3. 아티팩트 목록에서 아티팩트 유형을 확장하세요.
4. TTL 정책을 편집할 아티팩트 버전을 선택하세요.
5. Version 탭을 클릭하세요.
6. **레지스트리에 연결** 버튼 옆의 **액션 ()** 메뉴를 클릭하세요.
7. 드롭다운에서 **TTL 정책 편집**을 선택하세요.
8. 표시되는 모달에서 TTL 정책 드롭다운에서 **비활성화**를 선택하세요.
9. 변경 사항을 저장하려면 **TTL 업데이트** 버튼을 선택하세요.
TTL 정책 보기
아티팩트의 TTL 정책을 Python SDK 또는 W\&B App UI로 확인하세요.
print 문을 사용하여 아티팩트의 TTL 정책을 확인하세요. 다음 예시는 아티팩트를 가져와 TTL 정책을 확인하는 방법을 보여줍니다:
```python theme={"system"}
artifact = run.use_artifact("")
print(artifact.ttl)
```
W\&B App UI로 아티팩트의 TTL 정책을 확인하세요.
1. [W\&B App](https://forge.coreweave.com/wandb)으로 이동하세요.
2. W\&B 프로젝트로 이동하세요.
3. 프로젝트 사이드바에서 Artifacts 탭을 선택하세요.
4. 컬렉션을 클릭하세요.
컬렉션 뷰에서 선택한 컬렉션의 모든 아티팩트를 확인할 수 있습니다. `Time to Live` 열에서 해당 아티팩트에 부여된 TTL 정책을 확인할 수 있습니다.
연결된 아티팩트 버전의 TTL 정책
W\&B는 프로덕션 워크플로에서 사용되는 아티팩트가 만료되지 않도록 연결된 아티팩트 버전의 TTL 정책을 비활성화합니다.
아티팩트 버전을 레지스트리 컬렉션에 연결하면 W\&B는 해당 TTL 정책을 비활성화하고 TTL을 `None`으로 설정합니다. 이후 아티팩트 버전의 연결을 해제하더라도 W\&B는 이전 TTL 정책이나 해당 기간을 복원하지 않습니다. 연결을 해제한 후에도 아티팩트 버전에 TTL 정책이 필요하다면 새 TTL 정책을 설정하세요.
## Related topics
- [아티팩트 버전을 컬렉션에 연결하기](/ko/products/registry/link_version.md)
