احفظ ملفاتك في مخزن
أنشئ مخزنا، وخذ عنوانه ومفاتيحه، واستعمله من أي S3 client.
كل الصفحات
- في الـ console، اضغط ⌘K واختر مساحة العمل › مخزن جديد. اكتب اسما من 3 إلى 63 حرفا: حروف لاتينية صغيرة وأرقام وشرطات، ويبدأ وينتهي بحرف أو رقم.
الاسم هو عنوان المخزن، ولا يتغير لاحقا.
- اختر الموقع الذي يعيش فيه المخزن واختر إنشاء.
تبقى الملفات في الموقع الذي اخترته، ولا تتغير لاحقا. لا يكون لمخزنين الاسم نفسه، في أي موقع.
المخزن تابع لـ مساحة العمل وليس لمشروع، وليس له نشرات. إذا لم يكن في خطتك مكان لمخزن آخر، يعرض الـ console لا متسع في الخطة لهذا المخزن ولا ينشئ شيئا؛ مساحة كل خطة موجودة في الحدود والأسعار. تحسب الملفات المخزنة بالـ GB كل شهر، والملفات التي لم تقرأ منذ 30 يوما تحسب بسعر البارد، كما تشرح الفوترة.
ومن الـ CLI، ghaym cloud buckets create --name my-bucket --site amman-1 ينشئ مخزنا، و ghaym cloud buckets credentials get my-bucket --show يطبع مفاتيحه عندما يجهز.
نسخ الملفات القديمة، وقفل الملفات، ونسخة ثانية من المخزن، ونطاق خاص على المخزن.
افتح المخزن من المخازن. تحت العناوين ثلاث قيم:
- العنوان العام:
https://my-bucket.s3.jo.cloud.ghaym.me، للتوقيع المسبق والقراءة العامة. - العنوان داخل المشروع:
http://s3، من داخل شبكة المشروع فقط. - منطقة التوقيع:
jo، رمز الدولة الذي يوقع به الـ S3 client.
تحت المفاتيح، اختر إظهار المفاتيح لتقرأ الـ access key ID والـ secret access key. يقبل أي S3 client هذه القيم؛ لا توجد مكتبة من غيم عليك تنزيلها. لتعطي هذه القيم لخدمة كمتغيرات، اربط المخزن بها. المخزن يربط بخدمة في موقعه وحده.
من خدمة، استعمل العنوان داخل المشروع مع الـ path-style:
import { PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
const s3 = new S3Client({
endpoint: process.env.S3_ENDPOINT,
region: process.env.S3_REGION,
forcePathStyle: true,
credentials: {
accessKeyId: process.env.S3_ACCESS_KEY_ID,
secretAccessKey: process.env.S3_SECRET_ACCESS_KEY,
},
});
await s3.send(
new PutObjectCommand({ Bucket: process.env.S3_BUCKET, Key: "reports/june.pdf", Body: bytes }),
);import os
import boto3
from botocore.config import Config
s3 = boto3.client(
"s3",
endpoint_url=os.environ["S3_ENDPOINT"],
region_name=os.environ["S3_REGION"],
aws_access_key_id=os.environ["S3_ACCESS_KEY_ID"],
aws_secret_access_key=os.environ["S3_SECRET_ACCESS_KEY"],
config=Config(s3={"addressing_style": "path"}),
)
s3.upload_file("june.pdf", os.environ["S3_BUCKET"], "reports/june.pdf")من حاسوبك، أو CI، أو خادم خارج غيم، أعط الـ client العنوان https://s3.jo.cloud.ghaym.me والمنطقة jo، واترك الـ path-style مطفأ: يضع الـ client اسم المخزن قبله، وهكذا ينتج العنوان العام.
const s3 = new S3Client({
endpoint: "https://s3.jo.cloud.ghaym.me",
region: "jo",
credentials: {
accessKeyId: process.env.S3_ACCESS_KEY_ID,
secretAccessKey: process.env.S3_SECRET_ACCESS_KEY,
},
});افتح المخزن، واضغط ⌘K واختر جعل المخزن عاما. يستطيع أي شخص قراءة ملفات المخزن من الرابط. أما عرض الملفات والكتابة فيحتاجان إلى مفتاح. تعرض الملفات العامة من العنوان العام.
لتغلقه مرة أخرى، اختر جعل المخزن خاصا: لا يقرأ ملف منه إلا بطلب موقع.
لتبدل المفاتيح، افتح المخزن، واضغط ⌘K واختر تدوير المفاتيح. إذا لم تكن هناك خدمة مربوطة، تتوقف المفاتيح الحالية فورا. وإذا كانت هناك خدمات مربوطة، تبقى المفاتيح الحالية صالحة حتى يعاد نشر الخدمات، يوما واحدا على الأكثر. وأي client آخر يستعملها يحتاج إلى المفاتيح الجديدة.
لتحذف المخزن، اضغط ⌘K، واختر حذف المخزن واكتب اسم المخزن للتأكيد. حذف المخزن يمحو ملفاته ومفاتيحه. ولا يبقى منه شيء.