From 145cd31fab981e5404ac619ecdaa2e83c6636a03 Mon Sep 17 00:00:00 2001 From: Noah Talerman Date: Mon, 28 Oct 2024 13:50:09 -0400 Subject: [PATCH] Guides --- articles/automatic-software-install-in-fleet.md | 8 ++++---- articles/policy-automation-run-script.md | 4 +++- .../automatic-software-install-top-image.png | Bin 8421 -> 0 bytes 3 files changed, 7 insertions(+), 5 deletions(-) delete mode 100644 website/assets/images/articles/automatic-software-install-top-image.png diff --git a/articles/automatic-software-install-in-fleet.md b/articles/automatic-software-install-in-fleet.md index 0b392f9cd89c..007af639e0b3 100644 --- a/articles/automatic-software-install-in-fleet.md +++ b/articles/automatic-software-install-in-fleet.md @@ -1,6 +1,4 @@ -# Automatic policy-based installation of software on hosts - -![Top Image](../website/assets/images/articles/automatic-software-install-top-image.png) +# Automatically install software Fleet [v4.57.0](https://github.com/fleetdm/fleet/releases/tag/fleet-v4.57.0) introduces the ability to automatically and remotely install software on hosts based on predefined policy failures. This guide will walk you through the process of configuring fleet for automatic installation of software on hosts using uploaded installation images and based on programmed policies. You'll learn how to configure and use this feature, as well as understand how the underlying mechanism works. @@ -46,6 +44,8 @@ Note: In order to know the exact application name to put in the query (e.g. "Ado Upon failure of the selected policy, the selected software installation will be triggered. +> Adding software to a policy will reset the policy's host counts. + ## How does it work? * After configuring Fleet to auto-install a specific software the rest will be done automatically. @@ -121,7 +121,7 @@ Leveraging Fleet’s ability to install and upgrade software on your hosts, you By automating software deployment, you can gain greater control over what's installed on your machines and have better oversight of version upgrades, ensuring old software with known issues is replaced. - + diff --git a/articles/policy-automation-run-script.md b/articles/policy-automation-run-script.md index ed2d1ce82ab9..c050fe072661 100644 --- a/articles/policy-automation-run-script.md +++ b/articles/policy-automation-run-script.md @@ -18,6 +18,8 @@ Fleet allows users to upload scripts executed on macOS, Windows, and Linux hosts The next time a fleetd host fails the policy you added automation for, Fleet will queue up the script you selected and run it on the host as if you had requested a script run manually. +> Adding a script to a policy will reset the policy's host counts. + ## How does it work? * Online hosts report policy status when on a configurable cadence, with hourly default. @@ -42,7 +44,7 @@ Fleet now supports running scripts on hosts that fail a policy check. We showed Host condition-related issues can be resolved by running a script on those hosts. You can now automate those resolutions inside Fleet, allowing zero-touch remediation of policy failures on hosts running fleetd. - + diff --git a/website/assets/images/articles/automatic-software-install-top-image.png b/website/assets/images/articles/automatic-software-install-top-image.png deleted file mode 100644 index ed188acd17ee6ba23b3175801afb0a1a9e9ead05..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 8421 zcmds+WmFu&+Mtn%-~od54N|l#-Izlx)KeHUu@PYo(|}_ZO0h%;^sGSqe)M8fopF2GO%MN zaBzkebCJfG*_7H@QS<_WA0^q_eQjNFPRwbw60O;apeuPcN6dqw(E5mHcUIW(RA8x4 zfLt<+@mooC60HgiMd})DWCPJKg;5GAMS`fGE-`!O;Qr*KqKm z7H}Y-1`iZMpuoW)#)rVY0K?|8;@mcjpDFHc)3nu)B@5trM@i0NFn* zc!By~F%ud1A12OL0%RI;ieNE2M<|$+k(rU1Ob{6i2J<_bnDTxSm;9GI@JoQq+}YWl zmx;;E&5hBGjnU50jERMZhlh!om5G%V0$4ztJZzl}-66J4OR6Cu2toduIzf zTkzkwhDLTS&H`j)e;fLr&p+=I>TdC$mTaB=)h(cdOn)^@ER4)d{}UT<<^L=-5_{WY%M>FrT)9juva%$NmJtYfJP$`5FC=6H- zIAQgnBc$+HV0bzIjehI^kaTA}h{iVgP>nMJBn^n1{Qo}}frDO4cQOPV@wpoRo|tAv z&DCkHF-^$g(9_VM!DZ46zN@bPbrHc>q+U6rxp@IbN~IKbVEaJ#V-pI68vdM6-CH>_ zVz*YDwPW9K?K9pkiE1j?&A&07VcJ_Ref470&iOMRIr@jst%9WSRqfwKQq0-m~U0#5$~==Q*>=E zuIXDiYl-U%fH)z4feceh@{FAQg6?M{Wlzc!AfM z3*>JRp7#k#kI!&ps$?A^!ss&wXc7C7t4%8{w5KG?^tWr#g$vB=o}^L!E6wMiY?VDo~zEZxZKhcmxOo_F|d0K0_*74Stn%Oyh21SVaCu=M1u|N)g zaTr#{Mq(D;VVKL(L{rR2sLj8=R4*w*_)Sqzu=(RVNF18qm7Ny$aZ~iLK??ru1kfwY zcNjSFaDC;mo%jM=@R}26-F_ruJ4mnIcaUR4t6zk$;ZPHCC>1zDn{@QZ3T<7}ylDss zLNQ2}(jqqtGv^xU5&TZL1374GnePu89nD7VC=@{mIE`eT#-G*{Tn^4)#&o%spV+K5 zuwqh^2NVUngCqLi&tYT7TI;~6RD?u+W6x9(Y>6GF2;yO@-VGzRnpKx54;$S3#f&Ov z=}IM!bxIGcz=sI78`k^d3yUzcpW|pupS9e#d(!7>$Oz>_v7^hJ6Ne(C&MQ9um}^A2 ziu}s$z7!DbCq?cng{q}m8KR{`8uq&Ji}wWMk1~2hq#GCIN) zET(#;4A>lC=Qe3}#K6jfS+y6wDv)?T{LI+HJ5Y_(LYUAG&t#hpK065^?TZU2P(trj zD+#-sKDztmpFQ`xkhSW!2J6KBW#?KzqnGPN0x04m_X8L+3cYQpS);)aRmeq=n(_%>!AuJ!kwDOJ*~hu5 zbncW7k5aGz(8EXn=AOlCa= zr?Bz6JCW2=++c|NSn`G)52SI!j7WvjoL*kj(U0*6rm#Zzc`xxOOi-Y?inab_dP4`X z-Kk`fh>Lt?W&fw8Q9KV=$^mXO!5s-IwvJ$^)FTOZ#t?VX5Uwzy@2k)N1_>3B&>q9A8Zr^UhdRtiZh_ zd8OEp2Y{)B9Z)t#%_e0!2Z2tg9qTqkfdW(E`XFI^IdatS^ncfJv)eo;)@vi+=>;Eq zb7q0cKKgH%Zm&QWrNLo9{J{T9P|CU1&=?{qBO^zo9% zl0tcCIvuls0OI`>WopEb^!GQpO}G6cg(@WSY2mj*4Ck~*xAN>h{oW6!n!1CRo~WD|mwqVQPYxl5Anj|dnsyv6 zA(sQD4oKhK<)UJTFY(8F%lD#UqV_Vo4Nbch-(RDRkX*zFF{#ar8}VOEeGZF`=uIwn zpgZ!mUTDL<+@I+!=hFXtEqH@$r$DH*r*#Yy3S%)|?aIBk>kB0r>HS&f{O7>yEu-x! zmR%diTL*`;y{T%ByVV&KC8f8{PZ^viorldRRkn|6Q!(XHi?;3PBk7#u11o9#X!Vx5 z{(@Y8Xq<_9<;z?F@w2Er?J;djiZP+oFe<4#G-3U4MBn>C_?A?mR@` z>Ej1hRgEJ|rk95$3b?JD%n>xIH}39aR7^lWcw!U=xUB|Z2xW)&M;S5y`QJSjGd<%;BK=BD$BfbWtI4=H zU*vLauD&&q#@`Q)5*v6quQi?v=cpNi6%wqT%JW(jd%EL$GSw)++_(~+~KJ!KD$v(V&RX? zff{b)`tHiwHO7(x5mN67{l_{oVGMms*zxhor(2WHVi%@pEWX2vIxbK=@7yIUvbt>W z(c?~Q4vY1Vc6^=?Ns5mOPdMxhS?hFv)cKj36@|sD>Z5{%9S8)^{m%aX7#GQHK4|p%X+C`(fdM9{p;r%stnGkzCUTJU)x%G?3Q^s z>@8AUd5@bXJW~=@uZHb>r@9#f8Naw5?a#Gx!C&k=SCkE8TnesJbW>#xgVJ=~82VZq zGDAA!ckT`tdrB+)GPAr_9)iu6OOT!%hUz_Y{#?AdMC8wTR1ib?!q9)3XP2n8WcuVcqONj^b za1IXl<24drb#8z5Dd9LI47V|95D2PvPbqI1fmYXgy8c^gIT+f#lKUl3{reBn^BAErsid|fvGxv#7z!CmO8{4HKen#u;3q;e#c^9G+Za5kD$_qppk5vyo!cM1vT@*^*xp{8DP^&b3Qfo9ww^_-MpG1R=L`5@u5F>hZ zn@;~HF84gq5Ftte)+xerMoTPlJ)>V}gb$h7OR=Qol_CpjUnMzIiixrW#1qb(E_=2{?(Cp~**iD2@B+|8<*IiVr9#ba=#;Jr0AcEaSV8of%j5h6nfjgQE^v9YD` zXxj@dZ-GFn1R1h|Z164Y#STI8;8UATvf=L?2;Z;sx@qbG$|wyxR0--%q!%Ovrcj>K z89x0jtvNci1yqhL9O`=R)xOG^r#uuTc}>a{5ymh>v6m$hnXk_J>YDGyFK1n(+6Wt> zR1=WtpY&pW(jB#+X}2f*M)J=en%P>|y^YuR;U5_Gj@W$6!4QN61(EaKRV<%jR@0jo zT<_{93sZ@lqkQs9!#NE)NU}TG)lU)jj@np_Z##MS2X&^xsZqf+6dIxuQgFSpj5m~0 z*^^$c?R@T(pCoNo`hjU1B|&qcy%29WqEcbzAUtN+`p1x3$cd4m4~tFqu~jvC$FqY{ zMLz4S&a&z=vv=iSypxD8gNbfNVMo3-kG|>HBU(+a`ryr0?a805_#1742zda=VoyOx|5IwYED=u5tZi)IvT&>oTwu2n1(?mH5fkI5qJHlIk27C6;wEn^N6 zo-deoi=c!yfBK##=t)cppKZGI??}*Vg2?TDR0?`*W*)U_n6ZB4dMHLJLDR&1{=zW( zV+@aSNS3PoQ8VC!3a9l_v=B}P-~IIrUfY(}gL{0o&)Wk@Z@>164%BijPPL7--o=ED zsRY98@KnDdN*X(bCj@MLAFbKq+`5Tur|JCNw<&9L)#Chu-fb1Io935ve!IaQ4;g00 z2`S|_bUD68m`_}1#@>7fX4?a0c~rI)BbQ?8Qn$>ZLcTfKXSf|1s8NgcR?)te2wm88 z^i~bQyi&(4*D~!N%G?|fasGVXkQq>L0^OJkIc1(lQQ{ToFkqPwPsc+`SvQ$fq>NVh9ds(6I{msWioU=G6$$NbR zUm0K*ft_Km3~V(@?zm~33{^75H@;TQmpwN03JAa8QB>4obBR0bHA<|vNJ<>)WJ??_ zOhs_po_!zA&`oXR(*WKcv~J$j`T0&g*BX>bDf9D#NqOE_oH9B3UMA1YL2?^E5RL*Th8)h= zKFtLM`5}hp`)+7fcoXC>=@bW|KAW%{G_F1dx~*nZv&%8D}7^i zmh^QmRV%M?98W*d;x$MZS0DcXQk)c@KE zrSn2q+~$}8kAH)6ONf)*)(B+qK?90KBZ$zJqkUElNzRlQ*Ylb8kX)I)<{U3|`-OT| z#sFUTN1^>GT)*!)yR_6tBvg>CX+IHMWG*IP%ywNp@gTSS9s}m(y|E|Z>>Z_ z!E37WNFE1ncDKpksh`Dg2-)@p|D}Dt&|iuV<6sY zsdqc!1vOrW&f)5?JsCMU^))UYVbc-%yOK=b=vpHErxcXOle#Yl&;W9T)nVt2!jomO z8ima{BXhV2^R=$Dv@-8&jB8i!s}T*j>syKY{& zl5H1!&+m?TZx-^N^Uu@l)D6X?4W4`0`&`WSLpFn= zWg8Vq#R+mO z1@vMct4s>H85z?fx}nvrkA%x#CNkl@_v{TBuUh&|;aWqO?sr{}tL)RBZYLihLZ8J z%5d$}aP2}Nix-3E=`2(pk}Ng#R77L2i;kz~CxJ9=+URde_r=|#43U27R4qtRU=iO+ zy_MOv4zaip(u=X;V)Q$QaeJ065o&4f;B!J;=;>bF`ZC^i@Lt|}bw@O-CFBa*_a+;g zKDl-1bV^xJ;-1{OOfV(++P2qtq2lg7Pc`z0t5JoiyqeY|nCS;3=P8d~$k0|k+MV2;J8P8X%4&MpeeD5Mh{yX%Y|Df>zp z0yW<`tAAUtY&x05Cvf0#n0gCS3#ot(igxVND=pP^1tY%74VK^6Xb<@k`n6`cqCH^M z*THaAF9nyP8i$fySxl}vj6$a6 z-t-F)!Les(ZQmIYc24T>L_~+}fNOn$T?2}O(E2z6?GrZ=nduu#&Cp%Srv?}=KBm5* zQqRvxXi(_8`P*3-hrI(eViG+bhg$&?EkfOrY=rZhK^CjvZAkaWmY0JvB*bW!iCzXz zM1^|Sl*wbJ+tMinDsPBRe)_jT-Th*e5Wpg3wF%VA-%B7F%PhTIRDl!@y*X6(ly>ut z+jT+}dZ>Rs;iQ>kuFm=8)RXGoUQ%@&Oir$1f5CH(awj@#-}QN=5|)DClMNj5L=Y zFy5`G%RdO=wwzughh8cD4Aezp^|qewhiDxOyy#G`gck_HRU*DELyRJ9rA8F*f4s% zYrh^fOXL~iJS%U0&>*GIQ%LH)f~&hQ(m5ssSE}A}I!aNfHC~1bPfxEF__2x^^b$De z4E{_K)c?`Lb?omFJ;v;qixsNr`Kgi_2Er**K@=AB(3Go zK1s?%%d1aR=oNbwLwW^o^2>UqLKjZwsTsrUK9n_jvee-8Dt_m6qeVRCJYD9pb%@i{ zkMX59qrDb-a~*28>GE_CF@DVrQa@!nScTzztw7-Yvm)g!E&UHij6!UZyiDB_vlekPkwy$q!mZ{lp z5h2VV4Gn8`7W`C}hn$fJnHdErWh1DBw0d?a=y32YMND9j99cwus#}_D1?t18glRAV zLIRL)!@15FsH74sE0@45`?Msk76pokf(y;>3z-oj!0R`->)Er0X=+#96$j>QiK zkmB?&QdEv<7z0Rw4VX}YS&#vwSo@0eHP(UfdGT=f8T7&NXUy