'\" t
.TH "SYSTEMD\-IMDS" "1" "" "systemd 261.2" "systemd-imds"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
systemd-imds, systemd-imds-import.service \- بازیابی و پردازش فراداده از سرویس‌های متادیتای ابری (IMDS)
.SH "خلاصه دستور (SYNOPSIS)"
.PP
systemd\-imds\-import\&.service
.HP \w'\fBsystemd\-imds\fR\ 'u
\fBsystemd\-imds\fR [OPTIONS...] [KEY]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsystemd\-imds\fR
ابزاری برای دریافت داده‌ها از IMDS (سرویس متادیتای نمونه یا Instance Metadata Service) است، که در بسیاری از محیط‌های ابری ارائه می‌شود\&. این ابزار یک کلاینت برای
\fBsystemd-imdsd@.service\fR(8)
است و دسترسی به داده‌های IMDS را از محیط‌های شل (shell) فراهم می‌کند\&.
.PP
این ابزار می‌تواند در یکی از پنج حالت زیر عمل کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بدون آرگومان‌های مکانی (و بدون سوییچ
\fB\-\-well\-known=\fR)
داده‌های عمومی سرویس IMDS و چند فیلد شناخته‌شده (well-known) به صورت خوانا برای انسان نمایش داده می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
با یک آرگومان مکانی (و بدون
\fB\-\-well\-known=\fR)
داده‌های IMDS که توسط کلید مشخص‌شده ارجاع داده شده‌اند دریافت شده و به صورت پردازش‌نشده در خروجی استاندارد نوشته می‌شوند\&. کلیدهای IMDS بخشی از نشانی اینترنتی (URL) دریافت IMDS هستند که به نشانی پایه اضافه می‌شوند\&. کلیدهای IMDS باید با یک اسلش ("/") آغاز شوند\&. توجه داشته باشید که کلیدهای IMDS معمولاً وابسته به پیاده‌سازی هستند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
با مشخص کردن گزینه
\fB\-\-well\-known=\fR
(در زیر ببینید)، فیلد شناخته‌شده‌ی مشخص‌شده به صورت پردازش‌نشده در خروجی استاندارد نوشته می‌شود\&. مفهوم فیلدهای شناخته‌شده، تفاوت‌های پیاده‌سازی IMDS را تا حدی انتزاعی می‌کند و یک رابط یکپارچه برای فیلدهای IMDS ارائه می‌دهد که معمولاً در بسیاری از پیاده‌سازی‌های مختلف وجود دارند، اما با کلیدهای مختص هر پیاده‌سازی در دسترس هستند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
با مشخص کردن گزینه
\fB\-\-userdata\fR
(در زیر ببینید)، داده‌های کاربر ("userdata") ارائه‌شده از طریق IMDS در خروجی استاندارد نوشته می‌شوند\&. در پشت صحنه این شبیه به
\fB\-\-well\-known=userdata\-base\fR،
\fB\-\-well\-known=userdata\fR
یا
\fB\-\-well\-known=userdata\-base64\fR
است\&. هر یک از این سه مورد به نوبت (به همین ترتیب) بررسی و امتحان می‌شوند و نخستین مورد موجود بازگردانده می‌شود\&. برای
\fB\-\-well\-known=userdata\-base\fR
آیتم داده کاربر
"systemd\-userdata"
درخواست می‌شود\&. برای
\fB\-\-well\-known=userdata\-base64\fR
داده‌های بازگردانده شده به صورت خودکار رمزگشایی Base64 می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
با مشخص کردن گزینه
\fB\-\-import\fR،
فیلدهای مختلف شناخته‌شده و داده‌های کاربر به مخزن محلی اطلاعات احراز هویت (credential store) وارد می‌شوند، جایی که از آن‌ها برای پیکربندی و پارامتربندی سیستم استفاده می‌شود\&. برای جزئیات به زیر مراجعه کنید\&.
.RE
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-\-well\-known=\fR, \fB\-K\fR
.RS 4
یکی از مقادیر
"hostname"،
"region"،
"zone"،
"ipv4\-public"،
"ipv6\-public"،
"ssh\-key"،
"userdata"،
"userdata\-base"،
"userdata\-base64"
را می‌پذیرد\&. یک فیلد خاص شناخته‌شده ("well-known") را از IMDS دریافت می‌کند\&. بسیاری از این فیلدها معمولاً توسط پیاده‌سازی‌های مختلف IMDS پشتیبانی می‌شوند، اما عموماً برخی از فیلدها پشتیبانی نمی‌شوند\&. توجه داشته باشید که اگر از
\fB\-\-well\-known=userdata\-base\fR
استفاده شود، باید یک زیرکلید اضافی به عنوان آرگومان مکانی مشخص شود، که آیتم خاص داده کاربر را برای دریافت تعیین می‌کند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-refresh=\fR
.RS 4
یک زمان بر حسب ثانیه را به عنوان آرگومان می‌گیرد و «تازه بودن» مورد نیاز داده‌ها را در صورتی که از داده‌های حافظه پنهان استفاده شود، مشخص می‌کند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-cache=\fR
.RS 4
یک مقدار بولی می‌پذیرد\&. اگر روی false تنظیم شود، حافظه پنهان محلی IMDS غیرفعال می‌شود و داده‌ها همیشه به صورت تازه از نقطه پایانی (endpoint) IMDS دریافت می‌شوند\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-userdata\fR, \fB\-u\fR
.RS 4
داده‌های کاربر IMDS این نمونه را در صورت موجود بودن دریافت می‌کند\&. برای جزئیات به بالا مراجعه کنید\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-\-import\fR
.RS 4
داده‌های IMDS را دریافت کرده و فیلدهای مرتبط را به عنوان اطلاعات احراز هویت (credentials) در
/run/credstore/
می‌نویسد\&. این در حال حاضر شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر داده‌های کاربر IMDS یک شیء معتبر JSON حاوی فیلد
\fIsystemd\&.credentials\fR
(با یک آرایه JSON به عنوان مقدار) باشد، پردازش شده و اطلاعات احراز هویت دلخواه فهرست‌شده در آرایه را وارد می‌کند\&. هر آیتم آرایه باید دارای فیلد
\fIname\fR
باشد که نام مدرک احراز هویت (credential) را نشان می‌دهد\&. ممکن است یکی از فیلدهای
\fItext\fR،
\fIdata\fR
یا
\fIencrypted\fR
را داشته باشد که حاوی داده‌های مدرک احراز هویت است\&. اگر از
\fItext\fR
استفاده شود، مقدار باید یک رشته تحت‌اللفظی از مقدار مدرک باشد\&. اگر از
\fIdata\fR
استفاده شود، مقدار می‌تواند داده‌های باینری دلخواه کدگذاری‌شده در یک رشته Base64 باشد\&. اگر از
\fIencrypted\fR
استفاده شود، مقدار باید یک مدرک احراز هویت رمزنگاری‌شده با کدگذاری Base64 باشد\&. برای اطلاعات درباره اطلاعات احراز هویتی که می‌توان از این طریق وارد کرد، به
\fBsystemd.system-credentials\fR(7)
مراجعه کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر فیلد شناخته‌شده‌ی
\fIssh\-key\fR
موجود باشد، مقدار آن به مدرک احراز هویت
\fIssh\&.authorized_keys\&.root\fR
وارد خواهد شد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اگر فیلد شناخته‌شده‌ی
\fIhostname\fR
موجود باشد، مقدار آن به مدرک احراز هویت
\fIfirstboot\&.hostname\fR
وارد خواهد شد\&.
.RE
.sp
این دستور توسط
systemd\-imds\-import\&.service
که هنگام بوت اجرا می‌شود فراخوانی می‌گردد\&.
.sp
در نسخه 261 اضافه شد\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
یک متن راهنمای کوتاه را چاپ کرده و خارج می‌شود\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
اطلاعات نسخه برنامه را نمایش داده و خارج می‌شود\&.
.RE
.SH "کدهای خروج (EXIT STATUS)"
.PP
در صورت موفقیت، 0 بازگردانده می‌شود، و در غیر این صورت یک کد خطای غیر صفر\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsystemd\fR(1), \fBsystemd-imdsd@.service\fR(8), \fBsystemd-imds-generator\fR(8), \fBsystemd.system-credentials\fR(7)