📘 תיעוד 250

ממשק שורת פקודה

נהל דליים ואובייקטים של R2 ישירות מהמסוף. השתמש בכלי CLI כדי להפוך משימות לאוטומטיות ולנהל אובייקטים.

#1. יצירת דלי

דלי מאחסן את האובייקטים שלך ב-R2. כדי ליצור דלי R2 חדש:

1. התחבר לחשבון Cloudflare שלך:

   העתק

   npx wrangler login

2. צור דלי בשם my-bucket:

   העתק

   npx wrangler r2 bucket create my-bucket

   אם מתבקשים, בחר את החשבון שבו ברצונך ליצור את הדלי.

3. אמת שהדלי נוצר:

   העתק

   npx wrangler r2 bucket list

4. בלוח הבקרה של Cloudflare, עבור אל R2 object storage. עבור אל Overview ↗

5. בחר Create bucket.

6. הזן שם לדלי.

7. בחר מיקום לדלי ומחלקת אחסון ברירת מחדל.

8. בחר Create bucket.

#2. יצירת אישורי API

כלי CLI שמשתמשים ב-API של S3 (AWS CLI, rclone) דורשים Access Key ID ו-Secret Access Key. אם אתה משתמש ב-Wrangler, אפשר לדלג על השלב הזה.

1. בלוח הבקרה של Cloudflare, עבור אל R2.
2. בחר Manage R2 API tokens.
3. בחר Create API token.
4. בחר הרשאת Object Read & Write ובחר את הדליים שאליהם ברצונך לגשת.
5. בחר Create API Token.
6. העתק את Access Key ID ואת Secret Access Key. אחסן אותם בצורה מאובטחת. אי אפשר לצפות בסוד שוב.

#3. הגדרת כלי CLI

Wrangler הוא ה-CLI של Cloudflare Workers. הוא מאמת מול חשבון Cloudflare שלך ישירות, ולכן אין צורך באישורי API.

1. התקן את Wrangler:

   npm

   העתק

   npm i -D wrangler

   yarn

   העתק

   yarn add -D wrangler

   pnpm

   העתק

   pnpm add -D wrangler

   bun

   העתק

   bun add -d wrangler

2. התחבר לחשבון Cloudflare שלך:

   העתק

   wrangler login

rclone מתאים להעלאות בכמות גדולה, להעברות ולסנכרון תיקיות.

1. התקן את rclone ↗︎ (גרסה 1.59 ואילך).

2. הגדר remote חדש:

   העתק

   rclone config

3. צור remote חדש על ידי בחירה ב-n.

4. תן ל-remote את השם r2

5. בחר Amazon S3 Compliant Storage Providers כסוג האחסון.

6. בחר Cloudflare R2 כספק.

7. בחר אם ברצונך להזין את אישורי AWS ידנית, או לקבל אותם מסביבת זמן הריצה.

8. הזן את Access Key ID ואת Secret Access Key כשמתבקשים.

9. בחר את האזור להתחברות (אופציונלי).

10. ספק את נקודת הקצה של S3 API.

AWS CLI עובד עם R2 על ידי ציון נקודת קצה מותאמת אישית.

1. התקן את AWS CLI ↗︎ עבור מערכת ההפעלה שלך.

2. הגדר את האישורים:

   העתק

   aws configure

3. כשמתבקשים, הזן:

   • AWS Access Key ID: ה-Access Key ID של R2 שלך
   • AWS Secret Access Key: ה-Secret Access Key של R2 שלך
   • Default region name: auto
   • Default output format: json (או הקש Enter כדי לדלג)

#4. העלאה והורדה של אובייקטים

(אופציונלי) צור קובץ בדיקה להעלאה. הרץ את הפקודה הזו בתיקייה שבה אתה מתכנן להריץ את פקודות ה-CLI:

echo 'Hello, R2!' > myfile.txt

# העלאת myfile.txt אל my-bucket
wrangler r2 object put my-bucket/myfile.txt --file ./myfile.txt

# הורדת myfile.txt ושמירתו בשם downloaded.txt
wrangler r2 object get my-bucket/myfile.txt --file ./downloaded.txt

עיין בפקודות Wrangler ל-R2 לכל הפעולות הזמינות.

# העלאת myfile.txt אל my-bucket
rclone copy myfile.txt r2:my-bucket/

# הורדת myfile.txt מ-my-bucket אל התיקייה הנוכחית
rclone copy r2:my-bucket/myfile.txt .

עיין בתיעוד של rclone לאפשרויות הגדרה נוספות.

# העלאת myfile.txt אל my-bucket
aws s3 cp myfile.txt s3://my-bucket/ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

# הורדת myfile.txt מ-my-bucket אל התיקייה הנוכחית
aws s3 cp s3://my-bucket/myfile.txt ./ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

# הצגת כל האובייקטים ב-my-bucket
aws s3 ls s3://my-bucket/ --endpoint-url https://<ACCOUNT_ID>.r2.cloudflarestorage.com

עיין בתיעוד של AWS CLI לדוגמאות נוספות.

#השלבים הבאים

#כתובות URL חתומות מראש

יצירת כתובות URL זמניות לגישה לאובייקט פרטי.

#דליים ציבוריים

הגשת קבצים ישירות דרך HTTP עם דלי ציבורי.

#CORS

הגדרת CORS להעלאות מבוססות דפדפן.

#מחזורי חיים של אובייקטים

הגדרת כללי מחזור חיים למחיקה אוטומטית של אובייקטים ישנים.