نصب و پیکربندی عوامل

می توانید عامل ها را در *nix، Windows یا macOS نصب کنید.

پس از نصب یک عامل، باید مراحل را در Configure agents کامل کنید.

عوامل را نصب کنید

*nix agents را نصب کنید

شما می توانید *nix agents را با استفاده از یک اسکریپت نصب نصب کنید.

1. عامل را با استفاده از دستور مناسب با محیط خود نصب کنید.

عامل های ویندوز را نصب کنید

شما می توانید عامل های ویندوز را به صورت گرافیکی یا از طریق خط فرمان با استفاده از بسته . msi نصب کنید.

عامل های ویندوز را با بسته . msi نصب کنید

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

• Powershell را نصب کنید. بسته . msi به PowerShell 5 یا بالاتر نیاز دارد.
• بسته msi را دانلود کنید.

عوامل ویندوز را با نصب کننده نصب کنید

از نصب کننده MSI برای فرآیند نصب خودکارتر استفاده کنید. نصب کننده می تواند puppet. conf را پیکربندی کند، ویژگی های CSR ایجاد کند و عامل را برای صحبت با سرور اصلی شما پیکربندی کند.

1. نصب کننده را به عنوان مدیر اجرا کنید.
2. هنگامی که از شما خواسته شد، نام میزبان سرور اصلی خود را ارائه دهید، به عنوان مثال عروسکی.

عوامل ویندوز را با استفاده از msiexec از خط فرمان نصب کنید

اگر می خواهید puppet. conf، ویژگی های CSR یا ویژگی های عامل خاصی را سفارشی کنید، MSI را به صورت دستی از خط فرمان نصب کنید.

ویژگی های MSI

اگر عامل های ویندوز را از خط فرمان با استفاده از بسته . msi نصب کنید، می توانید به صورت اختیاری این ویژگی ها را مشخص کنید.

مهم: اگر یک مقدار غیر پیش فرض برای PUPPET_SERVER، PUPPET_CA_SERVER، PUPPET_AGENT_CERTNAME، یا PUPPET_AGENT_ENVIRONMENT تنظیم کنید، نصب کننده مقدار موجود را در puppet. conf جایگزین می کند و در هنگام ارتقا، مقدار جدیدی را دوباره استفاده می کند، مگر اینکه مقدار جدیدی را مشخص کنید. بنابراین، اگر این ویژگی ها را سفارشی کرده اید، تنظیمات را مستقیماً در puppet. conf تغییر ندهید. در عوض، نصب کننده را مجدداً اجرا کنید و در هنگام نصب مقدار جدیدی تنظیم کنید.

32 بیتی - C:Program FilesPuppet LabsPuppet

64 بیتی - C:Program FilesPuppet LabsPuppet

نام گواهی گره و نامی که هنگام درخواست کاتالوگ استفاده می کند.

برای بهترین سازگاری، مقدار certname را به حروف کوچک، اعداد، نقطه، زیرخط و خط تیره محدود کنید.

توجه: اگر مقداری برای متغیر محیطی از قبل در puppet. conf وجود داشته باشد، تعیین آن در حین نصب، آن مقدار را لغو نمی کند.

• خودکار - وقتی ویندوز شروع به کار کرد Agent راه اندازی می شود و در پس زمینه در حال اجرا باقی می ماند.
• دستی - عامل را می توان در کنسول خدمات یا با شروع خالص در خط فرمان راه اندازی کرد.
• غیرفعال - عامل نصب شده اما غیرفعال است. قبل از شروع سرویس ، باید نوع راه اندازی آن را در کنسول خدمات تغییر دهید.

حساب کاربری ویندوز سرویس عامل از آن استفاده می کند. این ویژگی در صورت نیاز به دسترسی به پرونده های سهام UNC مفید است ، زیرا حساب پیش فرض محلی سرویس نمی تواند به این منابع شبکه دسترسی پیدا کند.

حساب کاربری باید از قبل وجود داشته باشد ، و می تواند یک کاربر محلی یا دامنه باشد. نصب کننده اجازه می دهد تا کاربران دامنه حتی اگر قبلاً به دستگاه دسترسی نداشته باشند. Installer Grants را به عنوان سرویس به کاربر وارد می کند ، و اگر کاربر در حال حاضر یک مدیر محلی نباشد ، نصب کننده آن را به گروه سرپرستان اضافه می کند.

اگر Puppet_agent_account_user را مشخص کنید ، باید Puppet_Agent_Account_Password و Puppet_Agent_Account_Domain را نیز مشخص کنید مگر اینکه گره تحت GMSA باشد. برای GMSA ها ، شما باید Puppet_agent_account_user (کاربر GMSA) و Puppet_Agent_Account_Domain را مشخص کنید. Puppet_Agent_Account_Password را مشخص نکنید.

نکته مهم: اگر نیاز به پایین آمدن عوامل دارید ، هنگام فراخوانی msiexec. exe در خط فرمان از restallmode = amus استفاده کنید تا از حذف پرونده هایی که برنامه به آن نیاز دارد جلوگیری کنید.

AMUS AS PUPPET-AGENT 1. 10. 10 و عروسک عروسک 5. 3. 4

Omus در نسخه های قبلی

تنظیم پاکسازی رجیستری مدیر سرویس غیر مکعب (NSSM). این امر به شما امکان می دهد تا در یک زمینه کنترل حساب کاربری (UAC) محدود کننده نصب کنید ، یا هنگامی که نصب کننده مجوزهای لازم برای خواندن کلیدهای رجیستری را ندارد.

به روزرسانی یا کاهش عروسک 32 بیتی و 64 بیتی روی ویندوز

در صورت لزوم ، می توانید عروسک های 32 بیتی و 64 بیتی را روی گره های ویندوز ارتقا دهید یا کاهش دهید.

ارتقاء به 64 بیتی

برای به روزرسانی از عروسک 32 بیتی به 64 بیتی ، به سادگی عروسک 64 بیتی را نصب کنید. ابتدا نیازی به حذف نسخه 32 بیتی ندارید.

نصب کننده به طور خاص اطلاعات را در مناطق مختلف رجیستری ذخیره می کند تا امکان بازگشت به عامل 32 بیتی را فراهم کند.

پایین آمدن به 32 بیتی

اگر نیاز به جایگزینی نسخه 64 بیتی عروسکی با نسخه 32 بیتی دارید ، باید قبل از نصب بسته جدید ، عروسک را حذف نصب کنید.

می توانید عروسک را از طریق رابط Add یا حذف برنامه ها یا از خط فرمان حذف کنید.

برای حذف عروسکی از خط فرمان ، باید فایل اصلی MSI را داشته باشید یا کد Production of MSI نصب شده را بدانید:

هنگامی که عروسک عروسکی را حذف نصب می کنید ، Uninstaller فهرست برنامه های عروسکی ، خدمات عامل و کلیه کلیدهای مربوط به رجیستری را حذف می کند. این $ confdir ، $ codedir و $ vardir را دست نخورده ، از جمله کلیدهای SSL ، ترک می کند. برای حذف کامل عروسک از سیستم ، این دایرکتوری ها را به صورت دستی حذف کنید.

عوامل MACOS را نصب کنید

می توانید عوامل MACOS را از Finder ، خط فرمان یا Homebrew نصب کنید.

نکته مهم: برای نمایندگان MACOS ، این گواهی از نام دستگاه (مانند My-Example-MAC) گرفته شده است. برای جلوگیری از مشکلات نصب ، اطمینان حاصل کنید که نام گره از حروف Lowercases استفاده می کند. اگر نمی خواهید نام رایانه خود را تغییر دهید ، می توانید در صورت درخواست توسط نصب کننده ، مجوز عامل را در تمام حروف کوچک وارد کنید.

دسترسی کامل به دیسک برای عروسک در MacOS 10. 14 و جدیدتر را اضافه کنید

با شروع MACOS 10. 14 ، باید عروسک را به لیست دسترسی کامل دیسک یا Allowlist اضافه کنید تا عروسکی را با مجوزهای کامل اجرا کنید و برای مدیریت صحیح منابع مانند کاربر و گروه در سیستم خود استفاده کنید.

1. دستور زیر را اجرا کنید تا پسوند . sh را از پرونده wrapper. sh حذف کنید:

    

عوامل MACOS را از Finder نصب کنید

می توانید از Finder برای نصب عامل در دستگاه MACOS خود استفاده کنید.

1. بسته عامل . dmg را باز کرده و روی نصب . pkg کلیک کنید.
2. در گفتگوی Installer Prompts را دنبال کنید.

عوامل MACOS را از خط فرمان نصب کنید

می توانید از خط فرمان برای نصب عامل بر روی دستگاه MACOS استفاده کنید.

1. SSH را به عنوان یک کاربر ریشه یا sudo وارد گره کنید.
2. تصویر دیسک را سوار کنید: Sudo Hdiutil Mount

خطی به نظر می رسد که با /جلد /عروسک عروسکی به پایان می رسد. این مکان دایرکتوری نقطه کوه برای حجم مجازی است که از تصویر دیسک ایجاد شده است.

نمایندگان MACOS را با Homebrew نصب کنید

می توانید از Homebrew برای نصب عامل در دستگاه MacOS خود استفاده کنید.

عوامل را پیکربندی کنید

پس از نصب عوامل خود ، باید سه مرحله پیکربندی زیر را انجام دهید.

1. مسیر خود را برای دسترسی به دستورات عروسکی پیکربندی کنید

رابط خط فرمان عروسکی (CLI) از یکفرمان تک عروسکی با بسیاری از زیرمجموعه ها، به عنوان مثال عروس ک-مارپیچ.

دستورات عروسکی در دایرکتوری سطل قرار دارند -/opt/puppetlabs/bin/on *nix و c: پرونده های برنامه آزمایشگاه های عروسکی puppet bin on windows. دایرکتوری سطل به طور پیش فرض در متغیر محیط مسیر شما نیست. برای دسترسی به دستورات عروسکی ، باید دایرکتوری سطل را به مسیر خود اضافه کنید.

گزینه های زیر را انتخاب کنید.

لینوکس: یک اسکریپت را برای نصب عروسکی تهیه کنید

*NIX: دایرکتوری آزمایشگاه عروسک های عروسکی را به مسیر خود اضافه کنید

برای افزودن دایرکتوری سطل به مسیر خود در *nix ، اجرا کنید: از طرف دیگر ، می توانید این مکان را در هر کجا که مسیر خود را پیکربندی کنید ، مانند پرونده های پیکربندی . profile یا . bashrc خود اضافه کنید.

ویندوز: فهرست سطل آزمایشگاه عروسکی را به مسیر خود اضافه کنید

برای اجرای دستورات عروسکی در ویندوز ، یک فرمان را با امتیازات اداری شروع کنید. شما می توانید با کلیک راست بر روی برنامه Puppet Start با برنامه Puppet و کلیک روی Run به عنوان Administrator ، این کار را انجام دهید. اگر سیستم تأیید UAC را درخواست می کند ، بله را کلیک کنید.

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

2. تنظیمات سرور را پیکربندی کنید

سرور در حال تنظیم است ، که به شما امکان می دهد عامل را به سرور عروسکی اصلی متصل کنید ، تنها تنظیم اجباری است.

می توانید با استفاده از مجموعه پیکربندی Puppet Config Sub Command ، که به طور خودکار ویرایش می کند ، پیکربندی را به نمایندگان اضافه کنید ، یا ویرایش /etc/puppetlabs/puppet/puppet. conf را مستقیماً.

به صورت دستی ویرایش /etc/puppetlabs/puppet/puppet. conf یا c: programData puppetlabs puppet etct stuppet. conf.

توجه داشته باشید که مکان در ویندوز بستگی به این دارد که آیا شما با امتیازات اداری در حال اجرا هستید یا خیر. اگر نباشید ، در فهرست خانه قرار خواهد گرفت ، نه مکان سیستم.

این دستور Setting Server = PuppetServer. example.com را به بخش [اصلی] puppet. conf اضافه می کند.

توجه داشته باشید که تنظیمات اختیاری دیگری نیز وجود دارد ، به عنوان مثال ، ServerPort ، CA_SERVER ، CA_PORT ، Report_Server ، Report_port ، که ممکن است برای استقرار عروسکی پیچیده تر ، مانند هنگام استفاده از سرور CA و چندین کامپایلر ، به آنها نیاز داشته باشید.

3. عامل را به سرور اصلی وصل کنید و گواهی را امضا کنید

پس از اضافه کردن سرور ، باید عامل عروسکی را به سرور اصلی وصل کنید تا در فواصل منظم برای گزارش وضعیت آن ، بازیابی کاتالوگ آن و در صورت لزوم ، پیکربندی آن را به روز کنید.