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

می توانید عوامل را در *NIX ، Windows یا MacOS نصب کنید.

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

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

نصب *نمایندگان NIX

می توانید با استفاده از اسکریپت نصب ، نمایندگان *NIX را نصب کنید.

قبل از اینکه شروع کنی

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

sudo yum نصب عروسکی

sudo apt-get نصب عروسکی

توجه: مخزن عروسکی برای سیستم مدیریت بسته بندی APT عبارت است از: http://apt. puppetlabs. com/ Zypper:

sudo zypper نصب عروسکی

sudo/opt/puppetlabs/bin/puppet service service service puppet action = اجرای فعال = درست

نمایندگان ویندوز را نصب کنید

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

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

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

قبل از اینکه شروع کنی

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

نمایندگان ویندوز را با نصب نصب کنید

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

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

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

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

در خط فرمان گره ای که می خواهید عامل را نصب کنید ، دستور نصب را اجرا کنید:

msiexec /qn /norestart /i . msi

نکته: برای ورود به سیستم نصب به یک پرونده می توانید /l*v install. txt را مشخص کنید.

خواص MSI

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

نکته مهم: اگر یک مقدار غیر پیش فرض را برای Puppet_Server ، Puppet_ca_server ، Puppet_agent_certname یا Puppet_agent_environment تعیین کرده اید ، نصب کننده مقدار موجود را در Puppet. conf جایگزین می کند و از مقدار در ارتقاء مجدد استفاده می کند ، مگر اینکه مقدار جدیدی را مشخص کنید. بنابراین ، اگر این خصوصیات را سفارشی کرده اید ، تنظیمات را مستقیماً در Puppet. conf تغییر ندهید. در عوض ، نصب را مجدداً اجرا کنید و مقدار جدیدی را در نصب تنظیم کنید.

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

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

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

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

حساب کاربری ویندوز سرویس عامل از آن استفاده می کند. این ویژگی در صورت نیاز به دسترسی به پرونده های سهام 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) محدود کننده نصب کنید ، یا هنگامی که نصب کننده مجوزهای لازم برای خواندن کلیدهای رجیستری را ندارد.

توجه: این ممکن است باعث راه اندازی مجدد سرور DHCP یا سایر خدمات شود. برای نصب عامل با سرور اصلی در puppet. acme. com:

msiexec /qn /norestart /i puppet. msi puppet_server = puppet. acme. com

برای نصب نماینده در یک آزمایش کاربر دامنه bob:

msiexec /qn /norestart /i puppet-. msi puppet_agent_account_domain = examplecorp puppet_agent_account_user = bob puppet_agent_account_password = رمز عبور

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

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

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

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

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

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

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

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

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

msiexec /qn /norestart /x puppet-agent-1. 3. 0-x64. msi msiexec /qn /norestart /x

هنگامی که عروسک عروسکی را حذف نصب می کنید ، 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 حذف کنید:

    

mv /opt/puppetlabs/puppet/bin/wrapper. sh/opt/puppetlabs/عروسک/سطل/بسته بندی

L N-SF/OPT/PUPPETLABS/عروسک/سطل/بسته بندی/OPT/PUPPETLABS/BIN/FACTER

L N-SF/OPT/PUPPETLABS/عروسک/سطل/بسته بندی/OPT/PUPPETLABS/BIN/HIERA

L N-SF/OPT/PUPPETLABS/PUPPET/BIN/WRAPPER/OPT/PUPPETLABS/BIN/PUPPET

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

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

قبل از اینکه شروع کنی

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

شما باید نام میزبان سرور اصلی و گواهی عامل را درج کنید.

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

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

قبل از اینکه شروع کنی

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

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

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

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

قبل از اینکه شروع کنی Homebrew را نصب کنید. آخرین نسخه از نماینده عروسکی را نصب کنید:

Brew Cask نصب عروسک ها/عروسک/عروسک عروسکی را نصب کنید

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

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

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

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

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

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

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

اگر در لینوکس هستید ، می توانید اسکریپتی را تهیه کنید که نصب عروسک را نصب کند. دستور زیر را اجرا کنید:

منبع /etc/profile. d/puppet-agent. sh

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

برای افزودن فهرست سطل به مسیر خود در *nix ، اجرا کنید:

مسیر صادرات =/opt/puppetlabs/سطل: مسیر $

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

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

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

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

برای cmd. exe ، اجرا:

تنظیم مسیر = ٪ path ٪ ؛ "c:  پرونده های برنامه  آزمایشگاه های عروسکی  عروسک  bin"

برای PowerShell ، RUN:

 $ env: مسیر += "؛ c:  پرونده های برنامه  آزمایشگاه های عروسکی  عروسک  bin" 

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

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

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

در گره عامل ، اجرا کنید:

مجموعه پیکربندی عروسکی Puppetserver. example. co m-بخش اصلی

نتایج

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

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

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

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

1. برای اتصال عامل به سرور اصلی ، اجرا کنید:

    

بوت استرپ SSL عروسکی

توجه: برای عوامل عروسکی 5 ، به جای آن ، عامل عروسکی را اجرا کنید. پیامی را مشاهده خواهید کرد که به نظر می رسد:

اطلاعات: ایجاد یک کلید جدید RSA SSL برای

sudo puppetserver ca sign علام ت-نام

بوت استرپ SSL عروسکی