Wrangler 명령어

Wrangler CLI로 R2 버킷과 객체를 관리하는 명령어들을 자세히 배워 보아요. 각 명령어와 옵션, 플래그를 해요체로 설명드릴게요.

출처: 문서

본문

r2 bucket

R2 스토어의 버킷과 상호작용해요.

Note

r2 bucket 명령을 사용하면 R2 API를 이용해 Cloudflare 네트워크에 있는 애플리케이션 데이터를 관리하고 Workers에서 접근할 수 있어요.

r2 bucket create

새 R2 버킷을 만들어요

npx wrangler r2 bucket create <NAME>

yarn wrangler r2 bucket create <NAME>

pnpm wrangler r2 bucket create <NAME>

• <NAME> string required

  새 버킷의 이름

• --location string R2 버킷의 지리적 배치를 결정하는 선택적 위치 힌트

• --storage-class string alias: --s

  이 버킷에 업로드된 객체의 기본 스토리지 클래스

• --jurisdiction string alias: --J

  새 버킷이 생성될 관할권

• --use-remote boolean 새로 만든 리소스를 설정에 추가할 때 원격 바인딩을 사용해요

• --update-config boolean 새로 추가된 리소스로 설정 파일을 자동으로 업데이트해요

• --binding string Worker에서 이 리소스의 바인딩 이름

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket info

R2 버킷에 대한 정보를 가져와요

npx wrangler r2 bucket info <BUCKET>

yarn wrangler r2 bucket info <BUCKET>

pnpm wrangler r2 bucket info <BUCKET>

• <BUCKET> string required

  정보를 가져올 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --json boolean default: false

  버킷 정보를 JSON으로 반환해요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket delete

R2 버킷을 삭제해요

npx wrangler r2 bucket delete <BUCKET>

yarn wrangler r2 bucket delete <BUCKET>

pnpm wrangler r2 bucket delete <BUCKET>

• <BUCKET> string required

  삭제할 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket list

R2 버킷을 나열해요

npx wrangler r2 bucket list

yarn wrangler r2 bucket list

pnpm wrangler r2 bucket list

• --jurisdiction string alias: --J

  나열할 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

Basin Catalog

버킷에서 Basin Catalog를 활성화해요:

npx wrangler basin catalog enable <BUCKET_NAME>

yarn wrangler basin catalog enable <BUCKET_NAME>

pnpm wrangler basin catalog enable <BUCKET_NAME>

버킷에서 Basin Catalog를 비활성화해요:

npx wrangler basin catalog disable <BUCKET_NAME>

yarn wrangler basin catalog disable <BUCKET_NAME>

pnpm wrangler basin catalog disable <BUCKET_NAME>

버킷의 Basin Catalog 상태를 가져와요:

npx wrangler basin catalog get <BUCKET_NAME>

yarn wrangler basin catalog get <BUCKET_NAME>

pnpm wrangler basin catalog get <BUCKET_NAME>

basin catalog compaction enable

서비스 토큰으로 카탈로그 수준 컴팩션(compaction)을 활성화해요:

npx wrangler basin catalog compaction enable my-bucket --token <TOKEN>

yarn wrangler basin catalog compaction enable my-bucket --token <TOKEN>

pnpm wrangler basin catalog compaction enable my-bucket --token <TOKEN>

테이블 수준 컴팩션을 활성화해요:

npx wrangler basin catalog compaction enable my-bucket my-namespace my-table --target-size 256

yarn wrangler basin catalog compaction enable my-bucket my-namespace my-table --target-size 256

pnpm wrangler basin catalog compaction enable my-bucket my-namespace my-table --target-size 256

basin catalog compaction disable

카탈로그 수준 컴팩션을 비활성화해요:

npx wrangler basin catalog compaction disable my-bucket

yarn wrangler basin catalog compaction disable my-bucket

pnpm wrangler basin catalog compaction disable my-bucket

테이블 수준 컴팩션을 비활성화해요:

npx wrangler basin catalog compaction disable my-bucket my-namespace my-table

yarn wrangler basin catalog compaction disable my-bucket my-namespace my-table

pnpm wrangler basin catalog compaction disable my-bucket my-namespace my-table

스냅샷 만료(snapshot expiration)를 활성화해요:

npx wrangler basin catalog snapshot-expiration enable <BUCKET_NAME>

yarn wrangler basin catalog snapshot-expiration enable <BUCKET_NAME>

pnpm wrangler basin catalog snapshot-expiration enable <BUCKET_NAME>

스냅샷 만료를 비활성화해요:

npx wrangler basin catalog snapshot-expiration disable <BUCKET_NAME>

yarn wrangler basin catalog snapshot-expiration disable <BUCKET_NAME>

pnpm wrangler basin catalog snapshot-expiration disable <BUCKET_NAME>

r2 bucket cors set

JSON 파일에서 R2 버킷의 CORS 구성을 설정해요

npx wrangler r2 bucket cors set <BUCKET>

yarn wrangler r2 bucket cors set <BUCKET>

pnpm wrangler r2 bucket cors set <BUCKET>

• <BUCKET> string required

  CORS 구성을 설정할 R2 버킷의 이름

• --file string required

  CORS 구성을 포함한 JSON 파일 경로

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket cors delete

R2 버킷의 CORS 구성을 지워요

npx wrangler r2 bucket cors delete <BUCKET>

yarn wrangler r2 bucket cors delete <BUCKET>

pnpm wrangler r2 bucket cors delete <BUCKET>

• <BUCKET> string required

  CORS 구성을 삭제할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket cors list

R2 버킷의 CORS 규칙을 나열해요

npx wrangler r2 bucket cors list <BUCKET>

yarn wrangler r2 bucket cors list <BUCKET>

pnpm wrangler r2 bucket cors list <BUCKET>

• <BUCKET> string required

  CORS 규칙을 나열할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket dev-url enable

R2 버킷에 대해 r2.dev URL을 통한 공개 접근을 활성화해요

npx wrangler r2 bucket dev-url enable <BUCKET>

yarn wrangler r2 bucket dev-url enable <BUCKET>

pnpm wrangler r2 bucket dev-url enable <BUCKET>

• <BUCKET> string required

  r2.dev URL을 통해 공개 접근을 활성화할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket dev-url disable

R2 버킷에 대해 r2.dev URL을 통한 공개 접근을 비활성화해요

npx wrangler r2 bucket dev-url disable <BUCKET>

yarn wrangler r2 bucket dev-url disable <BUCKET>

pnpm wrangler r2 bucket dev-url disable <BUCKET>

• <BUCKET> string required

  r2.dev URL을 통해 공개 접근을 비활성화할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket dev-url get

R2 버킷의 r2.dev URL과 상태를 가져와요

npx wrangler r2 bucket dev-url get <BUCKET>

yarn wrangler r2 bucket dev-url get <BUCKET>

pnpm wrangler r2 bucket dev-url get <BUCKET>

• <BUCKET> string required

  r2.dev URL 상태를 가져올 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket domain add

R2 버킷에 커스텀 도메인을 연결해요

npx wrangler r2 bucket domain add <BUCKET>

yarn wrangler r2 bucket domain add <BUCKET>

pnpm wrangler r2 bucket domain add <BUCKET>

• <BUCKET> string required

  커스텀 도메인을 연결할 R2 버킷의 이름

• --domain string required

  R2 버킷에 연결할 커스텀 도메인

• --zone-id string required

  커스텀 도메인과 연결된 zone ID

• --min-tls string 커스텀 도메인의 최소 TLS 버전을 설정해요(설정하지 않으면 기본값 1.0)

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket domain remove

R2 버킷에서 커스텀 도메인을 제거해요

npx wrangler r2 bucket domain remove <BUCKET>

yarn wrangler r2 bucket domain remove <BUCKET>

pnpm wrangler r2 bucket domain remove <BUCKET>

• <BUCKET> string required

  커스텀 도메인을 제거할 R2 버킷의 이름

• --domain string required

  R2 버킷에서 제거할 커스텀 도메인

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket domain update

R2 버킷에 연결된 커스텀 도메인의 설정을 업데이트해요

npx wrangler r2 bucket domain update <BUCKET>

yarn wrangler r2 bucket domain update <BUCKET>

pnpm wrangler r2 bucket domain update <BUCKET>

• <BUCKET> string required

  업데이트할 커스텀 도메인과 연결된 R2 버킷의 이름

• --domain string required

  설정이 업데이트될 커스텀 도메인

• --min-tls string 커스텀 도메인의 최소 TLS 버전을 업데이트해요

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket domain get

R2 버킷에 연결된 커스텀 도메인을 가져와요

npx wrangler r2 bucket domain get <BUCKET>

yarn wrangler r2 bucket domain get <BUCKET>

pnpm wrangler r2 bucket domain get <BUCKET>

• <BUCKET> string required

  커스텀 도메인을 가져올 R2 버킷의 이름

• --domain string required

  정보를 가져올 커스텀 도메인

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket domain list

R2 버킷의 커스텀 도메인을 나열해요

npx wrangler r2 bucket domain list <BUCKET>

yarn wrangler r2 bucket domain list <BUCKET>

pnpm wrangler r2 bucket domain list <BUCKET>

• <BUCKET> string required

  연결된 커스텀 도메인이 나열될 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lifecycle add

R2 버킷에 수명 주기(lifecycle) 규칙을 추가해요

npx wrangler r2 bucket lifecycle add <BUCKET> [NAME] [PREFIX]

yarn wrangler r2 bucket lifecycle add <BUCKET> [NAME] [PREFIX]

pnpm wrangler r2 bucket lifecycle add <BUCKET> [NAME] [PREFIX]

• <BUCKET> string required

  수명 주기 규칙을 추가할 R2 버킷의 이름

• [NAME] string alias: --id

  수명 주기 규칙을 식별하고 관리하는 데 사용되는 고유한 이름

• [PREFIX] string 수명 주기 규칙의 접두사 조건 (모든 접두사에 대해 비워 두세요)

• --expire-days number 객체가 만료되는 일수

• --expire-date string 객체가 만료되는 날짜 (YYYY-MM-DD)

• --ia-transition-days number 객체가 Infrequent Access 스토리지로 전환되는 일수

• --ia-transition-date string 객체가 Infrequent Access 스토리지로 전환되는 날짜 (YYYY-MM-DD)

• --abort-multipart-days number 완료되지 않은 멀티파트 업로드가 중단되는 일수

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요 and data catalog validation prompt

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lifecycle remove

R2 버킷에서 수명 주기 규칙을 제거해요

npx wrangler r2 bucket lifecycle remove <BUCKET>

yarn wrangler r2 bucket lifecycle remove <BUCKET>

pnpm wrangler r2 bucket lifecycle remove <BUCKET>

• <BUCKET> string required

  수명 주기 규칙을 제거할 R2 버킷의 이름

• --name string alias: --idrequired

  제거할 수명 주기 규칙의 고유한 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lifecycle list

R2 버킷의 수명 주기 규칙을 나열해요

npx wrangler r2 bucket lifecycle list <BUCKET>

yarn wrangler r2 bucket lifecycle list <BUCKET>

pnpm wrangler r2 bucket lifecycle list <BUCKET>

• <BUCKET> string required

  수명 주기 규칙을 나열할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lifecycle set

JSON 파일에서 R2 버킷의 수명 주기 구성을 설정해요

npx wrangler r2 bucket lifecycle set <BUCKET>

yarn wrangler r2 bucket lifecycle set <BUCKET>

pnpm wrangler r2 bucket lifecycle set <BUCKET>

• <BUCKET> string required

  수명 주기 구성을 설정할 R2 버킷의 이름

• --file string required

  수명 주기 구성을 포함한 JSON 파일 경로

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요 and data catalog validation prompt

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lock add

R2 버킷에 잠금(lock) 규칙을 추가해요

npx wrangler r2 bucket lock add <BUCKET> [NAME] [PREFIX]

yarn wrangler r2 bucket lock add <BUCKET> [NAME] [PREFIX]

pnpm wrangler r2 bucket lock add <BUCKET> [NAME] [PREFIX]

• <BUCKET> string required

  버킷 잠금 규칙을 추가할 R2 버킷의 이름

• [NAME] string alias: --id

  버킷 잠금 규칙을 식별하고 관리하는 데 사용되는 고유한 이름

• [PREFIX] string 버킷 잠금 규칙의 접두사 조건 (모든 접두사에 대해 ""를 설정하세요)

• --retention-days number 객체가 보존될 일수

• --retention-date string 객체가 보존될 종료 날짜 (YYYY-MM-DD)

• --retention-indefinite boolean 객체를 무기한 보존해요

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lock remove

R2 버킷에서 버킷 잠금 규칙을 제거해요

npx wrangler r2 bucket lock remove <BUCKET>

yarn wrangler r2 bucket lock remove <BUCKET>

pnpm wrangler r2 bucket lock remove <BUCKET>

• <BUCKET> string required

  버킷 잠금 규칙을 제거할 R2 버킷의 이름

• --name string alias: --idrequired

  제거할 버킷 잠금 규칙의 고유한 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lock list

R2 버킷의 잠금 규칙을 나열해요

npx wrangler r2 bucket lock list <BUCKET>

yarn wrangler r2 bucket lock list <BUCKET>

pnpm wrangler r2 bucket lock list <BUCKET>

• <BUCKET> string required

  잠금 규칙을 나열할 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket lock set

JSON 파일에서 R2 버킷의 잠금 구성을 설정해요

npx wrangler r2 bucket lock set <BUCKET>

yarn wrangler r2 bucket lock set <BUCKET>

pnpm wrangler r2 bucket lock set <BUCKET>

• <BUCKET> string required

  잠금 구성을 설정할 R2 버킷의 이름

• --file string required

  잠금 구성을 포함한 JSON 파일 경로

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --force boolean alias: --ydefault: false

  확인을 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket notification create

R2 버킷에 대한 이벤트 알림 규칙을 만들어요

npx wrangler r2 bucket notification create <BUCKET>

yarn wrangler r2 bucket notification create <BUCKET>

pnpm wrangler r2 bucket notification create <BUCKET>

• <BUCKET> string required

  이벤트 알림 규칙을 만들 R2 버킷의 이름

• --event-types "object-create" | "object-delete" alias: --event-typerequired

  이벤트 알림을 발생시킬 이벤트 유형

• --prefix string 이벤트 알림을 발생시키기 위해 객체가 일치해야 하는 접두사 (참고: 정규 표현식은 지원되지 않아요)

• --suffix string 이벤트 알림을 발생시키기 위해 객체가 일치해야 하는 접미사 (참고: 정규 표현식은 지원되지 않아요)

• --queue string required

  이벤트 알림 메시지를 받을 큐의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --description string 생성 후 이벤트 알림 규칙을 식별하는 데 사용할 수 있는 설명

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket notification delete

R2 버킷에서 이벤트 알림 규칙을 삭제해요

npx wrangler r2 bucket notification delete <BUCKET>

yarn wrangler r2 bucket notification delete <BUCKET>

pnpm wrangler r2 bucket notification delete <BUCKET>

• <BUCKET> string required

  이벤트 알림 규칙을 삭제할 R2 버킷의 이름

• --queue string required

  이벤트 알림 규칙과 일치하는 큐의 이름. 규칙이 제공되지 않으면 버킷과 큐와 연결된 모든 이벤트 알림 규칙이 삭제돼요

• --rule string 삭제할 이벤트 알림 규칙의 ID

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket notification list

R2 버킷의 이벤트 알림 규칙을 나열해요

npx wrangler r2 bucket notification list <BUCKET>

yarn wrangler r2 bucket notification list <BUCKET>

pnpm wrangler r2 bucket notification list <BUCKET>

• <BUCKET> string required

  이벤트 알림 규칙을 가져올 R2 버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket sippy enable

R2 버킷에서 Sippy를 활성화해요

npx wrangler r2 bucket sippy enable <NAME>

yarn wrangler r2 bucket sippy enable <NAME>

pnpm wrangler r2 bucket sippy enable <NAME>

• <NAME> string required

  버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

• --provider "AWS" | "GCS"

• --bucket string 업스트림 버킷의 이름

• --region string (AWS 제공자 전용) 업스트림 버킷의 리전

• --access-key-id string (AWS 제공자 전용) 업스트림 버킷의 시크릿 액세스 키 id

• --secret-access-key string (AWS 제공자 전용) 업스트림 버킷의 시크릿 액세스 키

• --service-account-key-file string (GCS 제공자 전용) Google Cloud 서비스 계정 키 JSON 파일 경로

• --client-email string (GCS 제공자 전용) Google Cloud 서비스 계정 키의 클라이언트 이메일

• --private-key string (GCS 제공자 전용) Google Cloud 서비스 계정 키의 개인 키

• --r2-access-key-id string 이 R2 버킷의 시크릿 액세스 키 id

• --r2-secret-access-key string 이 R2 버킷의 시크릿 액세스 키

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket sippy disable

R2 버킷에서 Sippy를 비활성화해요

npx wrangler r2 bucket sippy disable <NAME>

yarn wrangler r2 bucket sippy disable <NAME>

pnpm wrangler r2 bucket sippy disable <NAME>

• <NAME> string required

  버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 bucket sippy get

R2 버킷에서 Sippy의 상태를 확인해요

npx wrangler r2 bucket sippy get <NAME>

yarn wrangler r2 bucket sippy get <NAME>

pnpm wrangler r2 bucket sippy get <NAME>

• <NAME> string required

  버킷의 이름

• --jurisdiction string alias: --J

  버킷이 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 object

R2 객체와 상호작용해요.

Note

r2 object 명령을 사용하면 R2 API를 이용해 Cloudflare 네트워크에 있는 애플리케이션 데이터를 관리하고 Workers에서 접근할 수 있어요.

r2 object get

R2 버킷에서 객체를 가져와요

npx wrangler r2 object get <OBJECTPATH>

yarn wrangler r2 object get <OBJECTPATH>

pnpm wrangler r2 object get <OBJECTPATH>

• <OBJECTPATH> string required

  {bucket}/{key} 형식의 소스 객체 경로

• --file string alias: --f

  생성할 대상 파일

• --pipe boolean alias: --p

  --file 옵션으로 지정하는 대신 파일을 대상으로 파이프할 수 있게 해요

• --local boolean 로컬 스토리지와 상호작용해요

• --remote boolean 원격 스토리지와 상호작용해요

• --persist-to string 로컬 영속화를 위한 디렉터리

• --jurisdiction string alias: --J

  객체가 존재하는 관할권

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 object put

R2 버킷에 객체를 만들어요

npx wrangler r2 object put <OBJECTPATH>

yarn wrangler r2 object put <OBJECTPATH>

pnpm wrangler r2 object put <OBJECTPATH>

• <OBJECTPATH> string required

  {bucket}/{key} 형식의 대상 객체 경로

• --content-type string alias: --ct

  객체 데이터의 형식을 설명하는 표준 MIME 유형

• --content-disposition string alias: --cd

  객체에 대한 표시 정보를 지정해요

• --content-encoding string alias: --ce

  객체에 적용된 콘텐츠 인코딩을 지정해서, Content-Type 헤더 필드가 참조하는 미디어 유형을 얻기 위해 어떤 디코딩 메커니즘을 적용해야 하는지 지정해요

• --content-language string alias: --cl

  콘텐츠가 사용하는 언어

• --cache-control string alias: --cc

  요청/응답 체인을 따라 캐싱 동작을 지정해요

• --expires string 객체가 더 이상 캐시 가능하지 않은 날짜와 시간

• --local boolean 로컬 스토리지와 상호작용해요

• --remote boolean 원격 스토리지와 상호작용해요

• --persist-to string 로컬 영속화를 위한 디렉터리

• --jurisdiction string alias: --J

  객체가 생성될 관할권

• --storage-class string alias: --s

  생성할 객체의 스토리지 클래스

• --force boolean alias: --ydefault: false

  데이터 카탈로그 검증 프롬프트를 건너뛰어요

• --file string alias: --f

  업로드할 파일 경로

• --pipe boolean alias: --p

  --file 옵션으로 지정하는 대신 파일을 파이프로 입력할 수 있게 해요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

r2 object delete

R2 버킷의 객체를 삭제해요

npx wrangler r2 object delete <OBJECTPATH>

yarn wrangler r2 object delete <OBJECTPATH>

pnpm wrangler r2 object delete <OBJECTPATH>

• <OBJECTPATH> string required

  {bucket}/{key} 형식의 대상 객체 경로

• --local boolean 로컬 스토리지와 상호작용해요

• --remote boolean 원격 스토리지와 상호작용해요

• --persist-to string 로컬 영속화를 위한 디렉터리

• --jurisdiction string alias: --J

  객체가 존재하는 관할권

• --force boolean alias: --ydefault: false

  데이터 카탈로그 검증 프롬프트를 건너뛰어요

전역 플래그(Global flags)

• --vboolean alias: --version

  버전 번호를 표시해요

• --cwdstring현재 작업 디렉터리 대신 지정한 디렉터리에서 Wrangler가 시작된 것처럼 실행해요

• --configstring alias: --c

  Wrangler 설정 파일 경로

• --envstring alias: --e

  작업에 사용할 환경. 그리고 .env와 .dev.vars 파일을 선택할 때 사용할 환경

• --env-filestring로드할 .env 파일 경로 - 여러 번 지정할 수 있어요 - 앞선 파일의 값은 이후 파일의 값으로 덮어써져요

• --install-skillsboolean default: false

  명령을 실행하기 전에 감지된 AI 코딩 에이전트용 Cloudflare skills를 설치해요

• --profilestring특정 인증 프로필을 사용해요

더 알아보기 (Learn more)

• Wrangler 명령어 개요
• R2 API
• R2 Workers API 참조