AWS CLI یک ابزار خط فرمان است که به شما امکان می‌دهد از طریق ترمینال به فضای ذخیره‌سازی متصل شوید و Bucketها و فایل‌های خود را مدیریت کنید.

نصب AWS CLI در Windows

برای استفاده از AWS CLI در ویندوز، ابتدا فایل نصب رسمی AWS CLI را دریافت کنید.

→ دانلود AWS CLI برای Windows

پس از دانلود فایل .msi ، آن را اجرا کرده و مراحل نصب را تکمیل کنید.

بررسی نصب

پس از پایان نصب، PowerShell یا Command Prompt را باز کرده و دستور زیر را اجرا کنید:

aws --version

در صورت نصب صحیح، نسخه AWS CLI در خروجی نمایش داده می‌شود.

نصب AWS CLI در Ubuntu و Debian

در سیستم‌های مبتنی بر Ubuntu و Debian، ابتدا فهرست پکیج‌ها را به‌روزرسانی کنید:

sudo apt update

سپس AWS CLI را نصب کنید:

sudo apt install awscli -y

بررسی نصب

پس از نصب، دستور زیر را اجرا کنید:

aws --version

در صورت نصب صحیح، نسخه AWS CLI در خروجی نمایش داده می‌شود.

دریافت اطلاعات دسترسی

برای اتصال به فضای ذخیره‌سازی به Access Key و Secret Key نیاز دارید.

برای ایجاد یا مشاهده اطلاعات دسترسی، وارد بخش مدیریت دسترسی شوید.

پس از ایجاد دسترسی، Access Key و Secret Key مربوط به آن را دریافت کنید.

نکته:
مقدار Secret Key را محرمانه نگه دارید و آن را در اختیار افراد غیرمجاز قرار ندهید.

انتخاب روش اتصال

پس از دریافت اطلاعات دسترسی، برای اتصال AWS CLI به فضای ذخیره‌سازی دو روش در اختیار دارید. کافی است یکی از روش‌های زیر را انتخاب کنید.

نکته:
برای استفاده معمول، یکی از دو روش را انتخاب کنید. در ادامه نحوه تنظیم هر دو روش توضیح داده شده است.

روش اول: ساخت پروفایل

در این روش، اطلاعات دسترسی در یک پروفایل مستقل ذخیره می‌شود. برای ایجاد پروفایل، دستور زیر را اجرا کنید:

aws configure --profile PROFILE_NAME

به‌جای PROFILE_NAME نام موردنظر خود را قرار دهید.

در زمان اجرای دستور، AWS CLI اطلاعات زیر را از شما دریافت می‌کند:

• AWS Access Key ID:مقدار Access Key خود را وارد کنید.
• AWS Secret Access Key:مقدار Secret Key خود را وارد کنید.
• Default region name:در صورت نیاز مقدار را وارد کنید؛ در غیر این صورت می‌توانید آن را خالی بگذارید.
• Default output format:در صورت نیاز فرمت خروجی را مشخص کنید؛ در غیر این صورت می‌توانید آن را خالی بگذارید.

پس از ساخت پروفایل، در دستورات AWS CLI نام پروفایل را با گزینه –profile مشخص کنید.

aws s3 ls --profile PROFILE_NAME --endpoint-url "https://s3-pish.runflare.cloud"

به‌جای PROFILE_NAME نام پروفایلی را که ایجاد کرده‌اید قرار دهید.

چه زمانی این روش مناسب است؟
اگر روی یک سیستم چند فضای ذخیره‌سازی یا چند مجموعه اطلاعات دسترسی دارید، استفاده از پروفایل به شما امکان می‌دهد آن‌ها را به‌صورت جداگانه مدیریت کنید.

روش دوم: تنظیم متغیرهای محیطی

در این روش، اطلاعات دسترسی در متغیرهای محیطی تنظیم می‌شوند و AWS CLI به‌صورت خودکار از آن‌ها استفاده می‌کند.

Windows – PowerShell

در PowerShell ابتدا Access Key را تنظیم کنید:

$env:AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY"

سپس Secret Key را تنظیم کنید:

$env:AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY"

مقادیر YOUR_ACCESS_KEY و YOUR_SECRET_KEY را با اطلاعات دسترسی خود جایگزین کنید.

Ubuntu و Debian

در ترمینال ابتدا Access Key را تنظیم کنید:

export AWS_ACCESS_KEY_ID="YOUR_ACCESS_KEY"

سپس Secret Key را تنظیم کنید:

export AWS_SECRET_ACCESS_KEY="YOUR_SECRET_KEY"

مقادیر YOUR_ACCESS_KEY و YOUR_SECRET_KEY را با اطلاعات دسترسی خود جایگزین کنید.

نکته:
دستورات AWS CLI را در همان ترمینالی اجرا کنید که اطلاعات دسترسی را در آن تنظیم کرده‌اید.

تست اتصال

پس از انتخاب و تکمیل یکی از روش‌های اتصال، می‌توانید اتصال AWS CLI به فضای ذخیره‌سازی را بررسی کنید.

اگر از پروفایل استفاده می‌کنید

aws s3 ls --profile PROFILE_NAME --endpoint-url "https://s3-pish.runflare.cloud"

به‌جای PROFILE_NAME نام پروفایل خود را قرار دهید.

اگر از متغیرهای محیطی استفاده می‌کنید

aws s3 ls --endpoint-url "https://s3-pish.runflare.cloud"

در صورت برقراری موفقیت‌آمیز اتصال و داشتن دسترسی لازم، فهرست Bucketهای قابل دسترسی نمایش داده می‌شود.

اگر خطا دریافت کردید:
صحت Access Key، Secret Key، نام پروفایل و آدرس Endpoint را بررسی کنید.

بررسی یک Bucket مشخص

پس از برقراری اتصال، می‌توانید دسترسی خود به یک Bucket مشخص را نیز بررسی کنید.

با استفاده از پروفایل

aws s3 ls s3://YOUR_BUCKET_NAME --profile PROFILE_NAME --endpoint-url "https://s3-pish.runflare.cloud"

با استفاده از متغیرهای محیطی

aws s3 ls s3://YOUR_BUCKET_NAME --endpoint-url "https://s3-pish.runflare.cloud"

به‌جای YOUR_BUCKET_NAME نام Bucket موردنظر و در صورت استفاده از پروفایل، به‌جای PROFILE_NAME نام پروفایل خود را وارد کنید.

در صورت داشتن دسترسی لازم، فایل‌ها و پوشه‌های موجود در Bucket در خروجی نمایش داده می‌شوند.