From 9eb54569d5f3bbda253a971f2548a49f4136a90c Mon Sep 17 00:00:00 2001 From: Brent Baude Date: Thu, 27 Feb 2025 13:56:27 -0600 Subject: [PATCH] Add applehv provisioning documentation Now that vfkit makes it easy to inject ignition files while booting FCOS, we can add some simple documentation for provisioning. This one is a hybrid between the hyperv and qemu provisioning documents. Signed-off-by: Brent Baude --- modules/ROOT/assets/images/vfkit.png | Bin 0 -> 35441 bytes modules/ROOT/nav.adoc | 1 + modules/ROOT/pages/provisioning-applehv.adoc | 57 +++++++++++++++++++ 3 files changed, 58 insertions(+) create mode 100644 modules/ROOT/assets/images/vfkit.png create mode 100644 modules/ROOT/pages/provisioning-applehv.adoc diff --git a/modules/ROOT/assets/images/vfkit.png b/modules/ROOT/assets/images/vfkit.png new file mode 100644 index 0000000000000000000000000000000000000000..f710c36bb8dd82b6311166cb8d43630f4ed859c4 GIT binary patch literal 35441 zcmb@tXIN8d7dFbEGmI5GifHVJ2oa^1L`6mEi1ZQ#si8=3DZ}WKt!4fNeB>H zAh7`g0ul%zw5XIwjUEq`iC3W>dMwX0a z8e`9I?6uOkdzss&?#ai8#!6kkDBGm9|L}%m>3i1|Fr*xuV~LNCNVorvi$7Vn=Y0R~ z_7y7eO~AKL9+xNlyy1qmLzpIx@nNlEVZ?Ro}$R%BA z1E2S}wWYZ?$WZDR`QJA0eUbXQb6eF#!*xF$sTyNWj2TFoCDnG8x~+)T)=nAgBYu&S zI=SoPCD&iH4tyN@GdZX^)l|yTXd4L;UJ@D4K4hA4=;tH)+Rbg}^wpXl^d{QoE_hw+=8@!PtL1~d%dImJPPkR+zuJC%)y09^&`P!zfxf90)@QYrteVo?%_MyA+w}Z#?P>t(}?^-XFW5k?)AK^9K3#1dJ?AZ5&l5kxn>Xf zE!|xekMaXh&#hL5A9m8zvfehOI3&~MyaL+}RrS15UaonN*%8yFXgmq*T1=VPQTj)_ zSl~lG8*|0>o?pO;U~Sgq{r06Ze~bZiI}UA&ynFM!Ou>si15#>djL2^{bd0lZo2#^h z)N9)vG2L^U>hLycte0^F*9>b&%1AmOWzCP6jBG@nfddcABf4zw?360C`*k+2>gR}` z-kFgESu?mGva*9YEH z{usTyZCDy}7ymNiqwBJUe!TQaon2ds6V4i`S>-?7c0>QvhT|8o7cw57vgAEIaYOI< zrm+3A1o5LhcOFi3`K7P&7G&NN-btz5vs_Zp(+wIEjj64O4u4946 zv{Jg$Fb}~U*5fMU4355l$f0pmIJM)pRxtaYD;UiPuvSL#>cxQ-c-6v1VE6*QyJZ@C%I8kj3+;aKc6M~OVwOMsxbxbuO z%8_f&UFK@OgXTm)M-^?h*hJWneINK%O}o(4G#YYh9iI>GA=(m4r@h0hd1rWjypd@+ zTAapH`7U|qq#a3x@+kFNX4ai|Ix})&)bY?{UmvKz_W?27H;*pgU*bc8mU;*Ff(i|a z410oT+o%0{b;`K$xQkvry`M7{H!W^=F>?XCJPXJRsGYAnXb3dMTjCwq&p=j~XP6?2 z8O0j;=6vg+w>L8`6uvxa`1|2r%bRttD>}ZUZGU~T#ktmlwn#!Js}HTiuOiES+b zEy{^AN$l*KX4xm6ogkS8(1o1m5XOXfnR(`nLaiUY%;*kO(s?T7W73v}@w30UcB>AMfL_77>z z^qX-f_1APR%}H1NEdH4!r(aPx@G}EjJ5w$4W#0r60xJQ*XYO3R^E9ZgyXdUpBae3- z$$O1tTZze~3KVUIo`>#%FkvraScfKf%>8h&<>KnArcEN3MQ3f*Fx4hpD1AL0;1V+u zI-(uG3+Nu8n3&|Hpbj zxRZi>-~U+g<^7jWKJ;(f_G&9bo}-?=z2V4W))_y0Z~L%;ggY}|Y(BbdPyf?nyUbD0 zmFPSg2ia`Fs;~+*adP6%U>qxFGT<%z5i5<~YrJSY-`-`@P`1&QhxNqboYrBlIrrAv zBK>;?V_{73x}V?t-uF9X6Lw?ACUALz1KqXACLPkZmdB1rYUVVjeiF^((dh`(s_QbG z|I5%8JuR5>#|&o`;wkLOypv;@E-NpEaqWN;S||KxM{iSn_@1+#J(Dp`!!-&g?M`(o zvzhYMM34P&r?wi|p)7yOb;9E(;W9ySp+VD)DP}?=K)BvB_D(WJVUPi>sUml6MgIrh{ zm1&f@E8BaJ3{U5Ii-T5ozDr9jjki$F_W_lyb&l6gx{5}7;jVBx#z-GI+&za}iD_Z) zTz47x7I?~ay3ucM^*()#@pGYE+7r8V_-1@-T*8{Auy8VI0X>FnSc`%m3%~sVJ3co~ zs^t5!`AGXO1tIF8i;UJq)ELGXR0aoq`9n|)J?%L=5xKNJ;0dR!jlLB46Eokm#KJsY zXGd44@^2S+nHx)g7(qzA4U)1L;wy~g40IH6Ls@V70iO6Lq#Ak(X?UvFEjX|8U{ z{<6`h=VpDA1i-p^*kAKBGm|m*k{Nq(i`e5BTYyOxqVA^DWx-qib2 zGLp|7l0VDG(*Jq74)A#0f3BtDzrJ|E+VI*n$)~k@u!l!Lh<9KpwdlN;1T-7?+^`R| zH#60B5A;{Pbvw|_Lp9R>&Q}pB{YYKOrN2k$twWLiegPr6kp@S;y`d|){(2jD83qP>9MV)hqk85DXyc(nhxCJQd+J`lbmebx$$th%yhB6p=mLQe5fQ2p z=TrlOy?|;uIy%5JXMtzWsz}~Y35f~_y%nhv5OVadM*h>zC65sIV4pjoK7j#;zP5YI zEif$9;K-4$9sT#`uW@=r`ux*VK*-yy94zRl~e z?)1MlrfcaF>EY*a$;V%^s*<6BG&RoXf9vLdp8PY=za(u!Jc11a{Uw5-pntaIZ{hDB z{#)={m-hd3simXyeV5-o`A+id6m%_ueI&iz`nrZ7HGSa!-23}|ec;yx{%*nl+Rblw zCEE$ws1N+FYJfJr4AA{qO6t7SwM!RnME*3}I#_v3=+^}Bx# z+un;UiOD~94*shvje8_kUGtpm*(v4E+mn)>`7Az;0R4H|BbBlF6LsC@-oh5$wqKq< zeWLnk-}ZS>Ox|1M%hGEd z9P#G849>0jydo{if~OF_I` z!pwS$G6YreRqn1gn0|~_-@!ZNS_5-o!hm}?~ zMCAGf>9j0*&4hrE%VHvX6Kw5+NRA2Si&jK=5u?WJCcdi>MG;>X3cA-cSHNrhwG0HO z5Q*NCa01!dEmDBQsIXz!nc{hrFV|MuDdgv&vdK-n7KiqB0l`A`gh3 z%$yuZG}-#gPrsg*lHT^4)cQkGlFJXH$?3nk{(BUbN8TU&nP5G^&Dg_Q<(-0$?Pp$H6C;-a zjD?fiU;j8`ru#8mYYfSDS+BG65`ql6$`w7pe7wK5g8tt*2+gXEQBI1;1FwRjN#O>Z|OJ zd4I?Vv~}Y0t%KipGjQ)WcbmcAE_U7F3TM?`${M4a%4V*@h0BVdeDZQLuw=hhKv7y++Ts!$iCLXz zud1#r)l$sxO-qgq;d6t3ywe46yn{bFINIoPdgkF1m&q$jLxPI#yN!iu)Xqj0Ps{}t zfrW(@{-F(Y@ah=Yvx!+MBYSZCS+`@8Ts|d_x9aWQ#AL~hlcy%uov#fTF|Mr|^#ZL- zZHlrw`TenoeYPI4%EgpMFryUVyfS<>GXYLMz^h=Bz#V#uNKx$?s7Wxne?L5MDF?mi z1wl*{^QNX8gbT83nqa>#emj%86!a*wa+GD+sX^Y%RJ|9*j2;3Vx*I3k8z(sPev08E zY|o;I2S$|^-`6=YJa!N>GO$@XOcCvY^;-k@|a;TnO znGN|a{e@?A&Dbp?9oNVOLAWZ5TXj^amZ}JT#EO`C6uxCo$M?n|*6{dEuU|&mnJ(bD zu3-YZ0xbS0JJgF)XR|O!5d725+TNxZ{_R01y1PDy^}AWjNUN&y+EN6?gdXVJogiAS zuW@lstzBBgHSTm9QVd{r86CitGA9NKI^A#+11#>8rC@rwRjzv=**XSyBOsr$0&^Va z(px@Dw5udSWu!}IZa%A1X^oP{jHXQ^KkdYLN93H&-17Y)k2C(z#2XiU1X|Udw`E`eAx!zK~rK5kIZPj^H!`@#p~_atJBH)>5mw^@k9I+AxiCq?+4s z@=>?@OQh9ugOMq0?I>b%VHuaiY@+2i(9X7}A*$C>BlgUmY<;(6GcV`m50A31WcBzk79_Wt-6!|zPShgZK2Osr36eu52L0jw;y z3KpMZYTQYC#*M&2tLSVXyaJol0m+Ymw_R2SeX($7j`**Q!GO09MgJ~(Ez7PgRVPB` zLShy5Hq6n*OC3!sA>0=1;>Q)m7&n*We(bqP6+K$}<#7Zlf?ngG0&FqoRt_2t$waZ) zo*=UhTc$5)@NlIL@%TX+!MdSbbN}~-bZf?ME>3e1s;i&SOjD#F3)zFfuP7pg7Qt)4 zA(P#Ht9!BlOZ-SL4-B+D?kH#e0{M#DyRaSBCp`5IEK!!KpNgAT#c$)3Zle$U9JRQG zIX(TwlCoNux5wmN^xUl{OP?<(GfHxB45PWL2G0ZaPGfCH*ZHt=hFUWYP7#+@+dlsB zx8wY}UN8RGUeWRM?7M@c5gc=pdpU;%#Ss~NSJKFQD|mI`A@gNMJz5ij^M??*a^YIf zT&{xCfRRzlFSgEQlk@h3xwdXSR}J6KIv_==>XYp8IeV(=V}jF6{>=DD?9!d)`Ua&T zPb0hXNvu~u-u~!S_zB33fQXSwLABl$hd0%{ko<-KmX};{)rIeO&vFB7J_G{|JjBDS z_O7i(#xKDc$%tjIXz^>X*ie)wEbd0G1`UJsk`ACFL!b1R&*Veia#jWA7f0K)nRajU z!b^|V)=ZE`s7vAGFEHe?!wJ+9{pf2DdVsv0+3BbW1zs>kr^ z7FNWq+v<-I_9+f+YGby^niFKC2Dfj#%b35H?K?H!Dh zp7aVCmp%I>RX-5KcWx(1@P2e89}gLBBb9}9k?RvBo-*c*#dUN!>VPJ+P6p0Eg>+x+T}vm=QP;17;r^=m(uVgURGg zS;zt|JQ!p}Q#y=%5Ongd;RpM%FgvWAYor>ZC({M8Y3Izj``<0?3($rEWZha2c{h7S zJTjb|*tj5^iIL#62$1=~{Gv5>92i@}C0Jzl{r;Vl)Oz8DfeR8iM>u+DY54(ojSFU5 z3_PrDi)b(aj~Ltev#;*m_g}~L4cDI8F!1QA?!>e(EM{p0QF9s8aT3c7+gWzU;=@XM z>BfK7PSVYt?dxZ64I-DkkPURIz?QU>(&Uf>j#d!4mRWE9-hOY>mX{XX`Vbz&2y@KO zJJ9*W;p7huRUoCKSnm0Nmk$BuwPT98Y^2hSdq2!$>!b6%pvc!aQAGlH;D6EB!7mju zGo381@$r=J4UMFU6p4?8>dl=Zq8wy?{h?E-SjY7_yy%RtV9gq%?h3v5FR*5p_L~bd zUjmZ}+#n4I#P;WZe7scb-NPvuZcnw|!Qr{-o31-gNPquO`P$f;T8Ex8FHRba6 zW=2Xn?!qAm_n`&J*P`i@Eh%mx^~|R4x4_vV{!b1aO25CmE#lgq<-A*XwOR7??kc{2vIt!+SD{brciU z{5?>StncGfv40%kd2_b@nuWHTNYws*Ws-k?aaTr`%3NDvmPU+5mAbIG-C&F>LNF0J z){<16-HomWp^wKq5c& z9DmdQexbj{1|RGwLYh&y{-x&dEAO&oV{Y$cIX~E>^8JVoRUG~)&)3FS3of# z`r)orY|;jGfzn-{Oys|hN#C(Mh}tp->#AP{f9OPN{q?FYI_yrf4txC%(|oKM>**gs z$_W~@@qhpM2c$EwVVsNYe{z1<0dztL$9)pHJ+aVn zncKU9b7nNP^a-ht|FIEq#*ZCXP|$2&Ss+q0gkpI^qH6@7s?6rcuHE?jIUx^%@!Q=F zzjQt9hEw8gyP=7-KL=i%cPy>|L6lrICwQIRt@imXWM)=i&?uhF@K4KUtkfOQ7aFOJ zPP!L6P%Q)6vS9U~4;U+X0nP2NE(eXFa*_{i4oK8Dn$P%64kL9(K-l zdPU3(Mbh+BoFikm(Wd`eBh_=Uf0!XM1Bv_b!U~|l!X}%kgcS0z4HuP4x=Udb410J- z8dErW5Ux3Td!|>*KwuNoE{3hXA1;E1-LRgs#ED%((jn3DY49{#d1~%+fzg(IQI^<*qwh~oa{JT)21`~#&IvU9WiQIiDV#~qI!`&>tYoJ)>Pk&v!d&XfT_teZ z)N?g;W`S6Z%h4#(I??U63z$TRLciHUOQo1Ntx}ykSx95~cA((CpA`wZ)lk=ERZZwp zUl~{h@_GN?7(LeTScN?vy$hh`4SCx@mfFHFflQXDHkuTcE!|l0A0thAH4JrG4VJir z#nl-J`2yq)vjC4MYpIh5 zT*3iWWn}zrO0{oenIro1vOtM)J1x){s%uSFXl?kkbIy8ln|rHoI86Z!m}v>hLL?4_ zIy)h~UFBSm-iUt!!xts%3MYT( z5rMa7r+(+4(Uz^(#^QcJ3x_InVov~8u67CwBN_&slTH6o)o%yGL)t8@`(@4_aho#@ z3IElozs}4+?s>$ko2$sxTX%nK(=zQmdGaU(-t`cbli2e;IFnj`Huf@T>Xe3HY7)6Z zUprv{Tdw%yi4$yTWXIx@&pzh15N__-EPpOGQ{4^DSb@1E^22z=*6kVH!6vJ!W>q5R z=F3|EJKX^y&HuWpR_1+ z6MBwh1(HD{hmjB$?iN~2Hd#37^=;U(WhRfW&A`TwLc&(_*f7@h@?f;A%349)vt;!n zrx|8;;5|oU64~O=y37GTs&>qSRT|8tdW`AQtaHknMmq8NlQhvMZDEin?o1& zm(VMeZG&78vn0hkSMeCvHEQno%#kzW?DjPHNl1u%eA>ak+@G_7w7?Bz};YQfMs#8 zZ;|)%vFygGj*`95iLCCHX^RD?^6n~vKNSpcnWf~I_~Zw9##@;$X0^oI1SomhY0@k^ zU8c-w3p@=)ycGwH1=fsnb6i%kSx_f)41}z$g)i6(VTzhu2rdXf8M)gELRRxvGU82C z5rid5YbS&tyBy-8KjL{oy*U=ZHEV@lr8_o<3*hBKkP%!^<6oHHl7ne^UKq3p^$SwF z0%8H#TBx(Q?CsHCnh{wXlY^xN zj&8TzC!#Qn#j&}5I~PU-&3BZF*0ue6chBE+lHQ~@H!b!Wo(ms~^YM`$g8i1<1EeWH zxgouBQi1!+dUux!*w?GdGHc6lwa?hBC)$D5&U5{~=FcEGg&YmL{aK&JG1Mz_*?Qx4 z;sHTua~Q*nDe?matpp|a;B{Ot?Pt}@=xm;n6=(pu?Q57a>*0$dVD~eD0E3Bk&}I`r;+`q+N&n$mvj-VnCv@7IKKExcY-6?@UrANr?A4p8@JzHRx(HKEs7)0%j*09ZQ zaX~Z-Yzd>bWdLZip#OP->R-0>CUZUKV=^i~xOl_o*Oq|aD|<6H{FzplQK;G#{h3SB zK6~Rk6EPqcyA)vO!|OQ;a8DSLbA&%TfIfE|SA(EChuhSely;120IHy+Ey4cQ$}!N~ zWfUeZw5ZHBoLE_wF_NW;5s!k16y-eo+RT9RbLybiRAIhFkzg zb}B-kq18!L-m3T4(J+&)vU3%Pg|oLGt@0=WL<4dSK{AG)d?ULd$sm5OGGmb1Iyv>O4}?9__;S(ho8I21R0VzWTS zTuluU?z2UpqS}&;HBlT?>92WOP^U@?cFS!!PT{u&VwrA<0(BX7LXGxP4krpt=V-u8 zp8>dTIPvp+t;fv*ts6r%=BWt?yv?*S;wojFU(ackS8HjFV!n@V#JM$fLIv_5&!@no z!z)S%pO!)DUXD|~Tl!Ao-fy7s#l+D&k}xAwv^1yQK@T42&eMy?cf7~&cVc;M>T(sd zo6Pj~R)q%ZnnP*L#MXb%-XQTIk>Y#Yu{X`nzp2#CQ$L04 zm+Uxt@LTYD>EeDB{b0(9}b-u}_I&#d!*fq(NTdriIuMI%9!GQy5G-=e%1 zHYZ*rx7Z-U9KOaGu`4?wL(5zwEdIZvj_CCq4S*SF%6GW8bH;3)#}5wb!}FcqT^0?e zz}{b;1M_)5hL577?*}fR7>P##B17}z-^(c|#+HnTw7ZB^zTe+Ie-pKy<6|dyYIKh2 ze$DvD)>^MVCY0u}6!U)I!X&iVQwcCuwRXhT(E@DR|NI`OOGyiI%a#t`RS~cjy7vqN*LDJ5#_vQ2|SgrCB z$oJxv{XZ}XZ!MOy8MkD&!oRrwCl~h@iFazJH-`Jt1CXI~RQA8<_iMxBUg&O?Pye04 z-Rz%#SeM7Du_Zo}VakuU{_y_!Lp!}~%Oo%`nB+3Lr+BN}Q2$vi+7w4*FWmOqc?0QA z-$$4`WYxcqH}P%*%S}V01^enXU`LwX}?x0bNpEd0HHlh#Dh1x{yIz%Jw5ojks2jF%b6p z3NCUgOk(OxG*qemL~=rITJ}=s1+He7kPs@#24YHb{=c?N! zMbP@Gd1omJxvz218Mr*1G8dyUt%l$fuRXE%3ZWpA9o3!3pcshqn=RhZ96r@Tn!h_M^J_kQ#4?y zqp}ZNG*JU!(B{L9S-uOh4;(zWJh6gM+*3;E<~O(ttqk2U%5Z^tO?GN0%X|urn_{4R zpB^aO$+}ME>Z*;3eEAVJBnu<5fB%s!O@RlyXlW;YVlT&>xF4w?c@ zSVtIC>rywh$l=7yfiR!oiQOs!4`rg7ojV@VuFNp5clV25$SIZt00LM51nj#^5N1-$ zlE^|s5c)377T(#`GR>F7%jv#RYnEF&Pz&LxRIr;$6cU5$cxr$}-X6dffsN26yemAXIqC5(m42q^8mnga6lNjv}QvViKC zmDKJbQzs$F0xn2*59bx))iu$x)I}`cgf7D3#i*>}96LgcJ*ZbxKA2YxRxf>fagZ}qr%q2bs|U5t zWE&*!hDMLFL@puK!_+;j5`vGA986j?A+!_vXQD&{t0}7~$zJNa^l12crS2A6{Ec21 zM|pJcdO1IE2td_BI=7zCFbTUK3ZJ{adV*_dUXCS9KMk)|2G_JFgzt}0X?|wYIPEPd z7**?U4HZ0bar_!Io};XImupX4CW$@m68)?P{W z)H)1V9_SqD-^Xwaa9&F}h>-Ykw_i_Zmf7S?tTme<&l^)d?9m%XMT_=|bbOLUPiLT? zQH8ZGmzY)AXB7ea*HWOf?o0KWw2@Z*^33VkkR+n-gSu{)cHO4_Fv=MQxv`zAedDlZ-O1{4ynnU+_vg+X0GpdQNHz@mTB(il`g-s|U- z0Q>d)P5$~EMs$WOyu6oBSz8$e*9b2&S9XP$c_U$qGEe&fm_Z@BV)U5T#wbGHVClGd z61Hg%_5w6Vmr}4iC@dBdO8QU4D9H@1ZulH#MOxeEXKTf6@?$G@##Gs)5mjOjuNop~ zwRHqSdx3<;+M0F#T!)OoqyS?Bk`8`UyWDyWkP1guxOJuT=>3?pSqbqH4W}%@5}TF- z9ZdvqHp+~sg0CUd{(R?dmZTEyo#1G=VD}PSJ$ZO-+g+TvfZi-F-rHMc21+7L_SjIA zM~8~Bj-#are>ja%O_SH`RAl=|M}rgpHde}CjTO_=**XRt^>9}G^hK4==|MKO`o@WT0s_|DkX9Ukc8q2I9Y?&ll`dg2Us0m zHL1*5P)iFs;5ghzB18M4$+Uw9T0=lgLco+*eawBy0urQVa%PBw^?rk5havLHYn3bh1A@sK;x8+?9g7 z$`sc`<)xAtyT(>nj0vR4LQe_7?u*cR#jyVQ7=6rtx-5y;`dPHM_u-W+7b2`|AbX~j zj2})l13^jRO6C6Pj*|Lx&hA2e=x#P#BFll5tKa4lj-%D@4`!DIDdBHe2XQhu6V`r^ zL>S1c+)P+4Nq|oNhy2L%6x_VOGF%_RQc|lLk|bNJw3v}$P48soVXP5Z>If+Uv$4ez zb$$xv-sF4I@FsG7WFQ-*k+EcWh+H}r39fqlH6;`K`skT3R$)Ew-MOijPIO#tsxs&( zs1CQh33j`qieEL_Yg7}O`5#j7#d_%~N#=L0gEz%+5b{Qt!Q<}IbBiRD<5xiv8@zjisie3`G^w?gAOS(f6hUh(Lr@pb{F^~^C+knpT@`EsT$zze)HleA5f*`--M&@b#nJ3qm+GOD4m9C zJ>)h8xFiUDULcI;tBoqgWSJqRmbDqaH3TxA*ydbR>YUVs6UGw=DDKi{<%xFN!Z|cu zb$ae16S}OkB}kppowPvZs8wdTso-wgB@?Og@z%+o{Pi`B>IoUPeGf-kWt%TiCUVT% z=ELHIISHZasuK>TZFuL2#pZNa`^;CkgU#qq7q+w8GcbFkx9v50T#tZ1oTTrW+u5bk zj5y45cVDS|mSI7ut8|*xL@(C#>`fz0!T1^!HR#D^Z~iyt`}Di}vu z4dHE~Dt-KPr$w+pAZ@VNEM%~_g#H}Mv@r>z3ALGk4oDD4YpM0ko7@6H^D-{T&Yyuz zMwl9gGua%`UX0h05;}M#$DN5X8$!{tk_9v^45D#FSkuND3h5S5MsZ|*S#qrdBz(et zW^V4#TCYde-!p#H%@TZQ)rIg03RxF!gh?;OSt2)=$%XuUqiRvc7Mbp{TolkZZ$f^` z<9GVJwR6O1pVCV9V3yd79NyCGBY`M@cFL($GkTeRkoC-5rOR$xjsB1O1c)R@wD&Y` z_*leHuD`D`{TvUDc1rAtY;VliNi>m%t8tbjyWvcVojc`U|U_{`aRFu zvS8zJTM;ZhrVr*$0L4-`aUHs;iY#allUy4SgcXI`Tw;sR9oGV4&LmG6ZApUT7AJZK z+>A9bdc}baC0^j?1>uS2xhB`TXWm4z%X;{{zFJ*$xm6VP(G#^Wf2wVn*j}+)P68N?U&fSBCRzDn zDx)MRN8Sk>B?|b0hoDKKIK3j0SJK@kob(UD= z7IZcBWT!P~swMj{WujSuahi@8N4e7$HDKkTignM zFSU4-fZ&;!Bp~GT(U|}zX5ev1UxGV^l7Q&rhn$*%Zc(!!xP%KzYe@ZQ$F(D4#3eJ< zV_1`?s}YFd_AUhyMK}<>_9n7LVu-`n?-Q)zhzD6lAXvl75g{aiUA3A5ZehF6vWj%(3vu}EYrjP?L8AQTbREIKa;u#?psHKL z>=|)NXycBCEo=w+_@1WBS`WH-`&m;0aa0LA>?RByNAD=h#cBHTIteC*OHYrBY@q!5 zE`L{)%N-O{rPE05I5S(v4-GE4-~2}RtMB(YFiMf6R?gX4a~a1X{I-1h>ceL( z3ieXKC-a*|!B>{zE+7@Qx=&9y3;O|VT0#Qo4Y;;d(8?~R7# zHqaF_f+0TkQ;YYhD>?0we8?xavN~_C&5}(2V!nPKf3%<*-#>GmdO#$vWIk)`C`pmV zmKjPifL^e2yDIgn1hDFYC$e!-=3Qn1*ll!AmR!gaN}#h71;13VtPf^_(*<)O2i-?y zgCy{y6K79*u&SLr*q-Ksoz27}B&k0C^19FG4)|Qg0Gtq6_fb`==>yq%p87?2o;TUI z$)!e(*Yaj_r%&R2RF7Dk+q8C;7uUay?&vsF0>jo!XN7j2piF)oYZ(_UtF4fu-8ro- zrq8S$Nz-o?4H)nl2!P2~o0b*q)~cC9Lok8mprCEq;nG!sVg|jR4;Z#!Q$hwu=T1p4 zAQcu(SnlIl7VZg33>c2B-0w$CQAvj9!#u5FS&(o5i#q`%7Ar7{3JBd<-G0X@40vLa z)`+o?nrY!)_R*h=7mk*YVdM-?B?unIbst ziVb#C-r|$hLVZw=D2D~6W%^0-t}s(cx~TbC5}~rSrl?@}bJ_^>&0emc?l7g=Em!@C z!Sv8T>q)$c)}+XJA~Gol;gdD}$ZVC`csoJOn(nn=Rj3Z2&2ZXOvD&H=9iCWDIo^2& z%0*OVxa}(IXPtD_Oxis}I|UMEKqSCY0pJeWUq;*uz}p9=by@BY(NLWb2uIm7TPK`c zl{~MyzYT1Ne;}-MO4O7%;`o9;Ua0M;i(tDpz(wIPhhA^>{06`_>%P4uW8fLMI+fKA zKzunff<)%ck2Z;JoVg#pe%VknX-+k2?mBev)Y48kjjnZR;S_G|EOzQ_XV~Yadw_2& zmGCR2=-n^SB$X{a;UaD|l8(QK;|4@+eYP)94G`aCyz1`EwTWJ_-}Dz9`QiEYZ1`MK z7M;%qUoGX!DF~h}PiK2Q&N&$Vvp{Th5uPA0 z)~pJwx@Ij;&i8Zie`k|R|DtwWlwy`+h@HM_F_x`JVVJ0m;++$e8BJHRAo5=k`mLRB zW%uc09vgfd))W=@qmpRaNb;refq2k7<$-%cE$BTa(Fe9D(3%E5dpdSfUny{*o4ea-|& z9U#yqnTC)#Aw+Pa3lauZb=5FIepr!dIT7;bAY8tf7br1!`Fx)_NtFS>dYTPI6c6^C z=Q^3O*mPz#9?7xemQMdb3AV{BM%$=9+A3HY6pbEFLW`VaPNL9&o^ zlU~3cunYr+C9Gzb{T~ups+IVtjLB{AhZYLxD{Z#agYNsEgRi`HD>@ez(9R7jI*e&C z40CI2$@G$!H?hF_8c}B9*kD*9J%dT-6F4#GZvIjMxf(|HYgds}9<CR9l7^GLft>)Q!%7u!QCBpm9Jk7Hx-?oxfOk1}Jt$`;}CR_lrr!P*I89VWs5 zcttb@QyVs+Jn9B-^bzG!2k1avQ$9U)gq1!WL*ZqV>cp6FTM3LB#*NnLX#Y;hu>m1W zNBp_)Ek030AdxL3WSdMGp3G;5xPGlx+#2`7Edz5WzhA)W*|T=uTb~xVAY4~8OzWn* zuR>wwM5I%nrE4`icy^|hH&;ofJrFv^Vea}_JNC}??&T;^s$Cf^-kUq?iw?sld{q(U zt0%CFt$p)URLFGv{z`u5VWFR27<_K8J8xI%>U#y>_L|#Sq#9Ey`6}a4U1}Sb!(N zofrAE9%o~nQ9BNQYQCMtvZVGko;D{G*BMp_>JPqxEosO&MMz>hr`eLpxwEbzpQABh zf|bDt9YFP0RCVP2xB*HX-A(;QNy!#Qrmz8}*Jf=Ch?$o5I1Hykr zDWv|XeRnq>=nIl_;6E>C_TNGe=9t!E2`XG1Y$ZSz+oVhZT0m{f>}iYPOuO8`PNv-0 z3OP`|INCMF6znTh=rjpy43vXUJvYBr6^JNa&Z(ioM3Vs_kIt?=1^P20h?-N^kai8$ zp*NgD9;JT$2GyOt>pk(Xm5>=)aK=0Z3}uJ!E}cNWpr zhg>Dv+w1^!!r;fX(7r}%@5QG_YjENa_D;&AgyA+*YoDV6a-8~9o25njF8`;R|H5tb zH1+ui-`-X1hx@X*y6R)rXIZrvy}weff5R8&%hCy9h?dsi=47KexvT?8gZFyAs{zsu zmF{etx)%NA!^?v1G{KKK&#c_@AvMk?NJG2-ot4d5zh^1sX(l7s*098fO=UcJczyg#f)dR#Ur;h>9B91-qlnd( zk(BeaKVxjAvAHprN$v10#lxyw0Ll^~Gv6^`A4j{wpY~GbFE*|2oupPvB$Q;btHik|*=eRP9r;1Hy6d<0s$6-%u!|%)kuy3eaJ(Pk+JaY*|4$^Xu{0YpqmvOv2fQO&`^nb^kTq1VgLS_nSj(nm=mi1*ic^$o(vo6 z|D4ln4{r{e3T0%}c1S8jl)EejD@9?Cu($0bL3t24BY*mNh9s1dBm_L!oaOllZ;Yur^ftfnJM>}mANpJrDfo@Hh~!mBH?ffMZBnr^|f zejFV*0uLsgBEG@R@Qo1I2s%D5^gk7Xa@P(4IQF$D-8D2tfDT<-U1^1U@xQ)w%Nx9O z_^GUEQmJs|NYnjU&#F%3haBuKNjTgO4Q)0hig>aUnf+(e&-DZSoByA-t~?&<_4{kC zZmL_fA={{K6e5L$#&lJFC8=b|9%bK3_8FSn_oggOk|lddma#MmF$`TzuBg`qQ42m_8LsA{LRUkTjZ^ ztD4^|K|MTtEForJ9AztopE;zVlYc(tx{+&AE{-^XF6y_N(xQJv+5gCzc~Cw$b3L-L zv9U$Y^0sRn;?KEKKGr}O{Oxju51D?jJ%oM`|M*Z<)Qk$=*SraLg~Y1v7;7;ij?Lqn z*z%6or`i=|PI{saF-seO43=atQbr1FG^6n*h%}{@7PV@7fAdQJr9FMm7Wb4ndgZ4s z1OxyV>|8*Iti!>;9Fe2Uyp6C+ZJFDb zOGg`1oO;t90DqT_74Ew?Dvbl}Sxm-OtHXuBP9Jq_$VWU%Yy2>+(vV=HGnJWERCmFj z!S_dL*}X;O`{#XE%-=7*%zDbyeRg`ax^+7;OogNj0;4+~!Ac zR@vY-=b`q5IFjibHF85Sn7%Aez-DyinwJ$U8>{G#JR>#Va@Ln+b;jxsE-qft_H3_3 zoHoK+SQg}XopU~Gb0DzBvL)WS$Ivofw^}9tHGjj6o&~LiADN>@|CCQeDg+|ni^eZE zNaxM;O$N+mcry9P^O#=c*}VwzL@hob3D^LpaFYL*6Dy=@A6DD)qktJ!aWmD4rJ5&O zQ1`_nJ6DzBTZXa~otD+RiSUjsXhw6`)$BOW82A%EAbdw}pwe$k2SEIXvg_l|G$ca>ghW+)F0O z`k&obb+D?Z;U#{t<;5y<#kONInwT+Yb z7x?51$30)0(i}rbPHn0Q=ah@zG>|EIzFR3yhu#qOOMbCXCSCwpuhLs8=QWsZGG~T} z9pmpcCL_)O6VWzHiAJ@=T&}qFVi)~-bWXlv6>DLk>?q5(}%vz{#)( zNa{EfS5wKnKiFHVIz!TaIwaaH)-i+0z9Z&zB znRoTUwh+)bg23(tz$Yewse0&_Mc>hw&*WcEjxO`U@uzireoQ)p%nd1(p0U~VnnmnC zW=_mOwLWSpw1wwo^s6ukV?Hho4c0e|5>c^tCv1As(=@tLh!er0t+Ny#G^5(yB=mN^ zR~VY8v}*{R&x*y4STU~0T{bt66b(|zO`r+K9nA|?TnyQ)XxW~CMa zV>nG#n#CkJvZVmJ2__Meqsekw9Eu_-Rpkbc(L(HS%XtVk#4rf zr74p*V~aM8^zYYQLRwbgmm}Qr)kQt?WLK_TgG-8dGhEItBsWh#*@5nNMTAw4u*All z^obyfvjz!?FSC_&^_J2nY34-Y;iPqHxEstkAOYk>a!X`0zW{`w*KtSUDo}Fb_+IUE|wbGYNGB`K5ZJjfhaRG=! zZsdjf$Uf>q3?gvGVS-*N|J}1uwSYC0JWZ2Y`NL(o;yvQxV&^T!9viQ57M>K<*Yji& zZBbFZAnZ0rpDOBi1&E#}oa8p77&l^&nT8szGN${-4T4Lx@i~`Z{Tx!BhNfXCQ1B&u z+^rY8>Fk72iUK9BY2|=)ftHA3KbCcC7fGmWZs>{-C3X5cYD?XmAlW#PiYreB01&{bj>=r{stj|`DQX#Qfdf=w3>kZw zd{^aiYhp|qQ$}-WXySt>+^Xy09Yk+RFrqwV=}1`qy&UDO*{QN+FYNH(7|mQnE5AWg zs!##si!az%?^I8v4IVzN<)QyDO!t^$92uk*1PEo1T+A%myrf0yyxteJ!xF1|`~Axo z((u({n`9}Fdrg&Tcr4DeqS}y>m!j{^|D!WxPRhziJI?Zq9P?yWk3=io5KY1BE+Li> zaePOaz-UPLgx>4K85D6+^MOx`Xp6phWk%%E zgO-TI+~ZQqXGeUSsM?maDJeQFuC>5vn_YuW_5?bA?o+FVk^*j&WdowX(OTstUB@Rg z&pV#@KAD-l7UE&3tJo}ZeO2{_BoF)3oGeX}5E{C04YQX7?@0vX+Nh@F%(G9;PZnPv zw6Lj*&=u*Ij>A3(n9TE;#1iGpZtcv)kGZv+(<$1o3%3aXc}Pl8UPd_7WOPB-a5OkX zwwRDr>2{GjG0p-BpOsAAn+PM|3tJK|k1L}}3ad3jj+SAuidxKIBapFfZG-Ezk2ajC zlNbuBGFNMMRnvF!3A>!LxS!nS8$BY8cBoX-3ZQJsZ+Wl~C7r~eOy(Vw8d+F;tgrww zd6~x#+O2fG<#9A z3plXn_>lzc2C6z-@3gn@yuc{WT`oJI{TJKRL?pQ-DyYKyo$a*L#VVRl{WL}2two*r#ZO4h`S;JGaq6J}n>YT^z2_E=ez`$}r4qPIXz9 zPipW!P*!p!E9ft)&x{E2NY5PNvq@6{)4Z4f90$E+-3}t|xP_rOK9A`=rGGv;(4JO1 ziBo)m`F=bt>7KO< zWuY6Tz&X{}Sv^H?dh9a}uK)9V7&gQ(f(qp}@N9LB6p8mn6q2eC#Op`P3U&0=L|6sG zAtI^5xy>X6ir*5V3?-OLY@cR=6H9WmC|X22>~g|o=Qj>ni|L|EfA?I{c*QT3Iq1O&(-lS+(nnlO10Pgl_*M4Xm`ORVWZZI8L4{XkWn(F?&vp9`EGzSc9RpUw?hy+gog?R)hqq`{7P zk6@!$s`h5R*-PfUg1gFOi_p`@*-l}Ijyb|$TDOz^g#@io&G*MEk6TpTT)dTyw+z7_ zBcSvxLSjCL3`l!wwhyvT9AsNN*jB9$T^O=pkUnd`N=I>T^Mmd zY)t4?O9}pDIp5c13i^lVSFXYvYe4Koc_ypFmAzpFn1ZveW_2;*k7Dx9_Ms{78TQrZ zW<}`f4QT}dTcosN{mk38R@T9X6Y^0S5?zLrb-zj*)K1iMc*q&St?=0Tk!Uf%;2|44d=umPwim zN_yGtEFIL&9|eD^QZP_1rBmoec1;qskM>~SYh_TzpZ@I?f$Jh!E-fw$e>&2qd7RAj zktwc7<{zB@)W7W^lZWqXtay3ItCWLgm84ttx?0QP&rbiqBg{tjiOsNdd|I2*kZV4U ze`OiD%!EZB=j zVM$+JSzvW-Jt8eDp5kt3CXGe_RunmB11yDj9HCnn&9p0nI&z-G3kSP#T zOb>UeIt|8 zU8jPk;R++cUiaqB-oIwV8qWr@lq|Qmb$lJHkFhe()6r8 zSBaWYpxg2KY-5`*ZLdXc(g<$K*o6`nmL!tKOn+FV?|FaKu87HEDmBQqa}yIE!m;Q( zA2-as%r9twXW|rg=8yl;@Y@RI&vKUSvD~2#0MV05We(6pM_>8h-a zz>0t(1W+1j_vNkj%4Nngn@h`g3vs!sxgyHLbgw)IG0lPNg)xXEri*^)^rBg5*_Qr6 zc&@^3H(7=ay7B;-m7-^p-DG`3mf~+}6bQo8NzYy5RO(VH@zyZCX!=8kvZ3otT~5I; zIJNAE8e^(5BU>qSugc8GGvKbcGRk^5uKS#hveK*?I6SOm-_+_b`&CjETqyG*&1o?? z9aI_H%zM*q3yTOexIIR${qfE)tok+gJ#r;(nEv3N#bCXbY(X zZAMnB&iYX8W1ihS&d*G%ZyIMEpJ4=n3;UpvV^7G(j(tBjdu0g=$wT3p#i01)R$p~M znmZ%2Yr`{yoDOcB9yyrSIkQJ&f3>yCg{X1r7wYlhIR=Oh`5DI&SdUz1+|)EjogYtn zyt&{OQGgP`MV3BEiNU)hMWJl+ciPcko3Wb3+GT9hBkxt}Hi)-G1-3FAF4U531A2xX z#qqlcdzNDZ>*t0<==6m#H?aDA`*-<(-vEMjWRTFTb|H;caST0G*S zbclo~VXTwLzqc6I*fnhp+GjUsC5SRZGtxXgDPCRG_LF;U;})Wv#zjqr+n8_*^1eiJ1a0or_Z0_tgjs# z-V#qOr1CS-a!c6l0(w(R>E40++DRy{t54^u?D3pvyr)%dcy;+YnH94RJNzg!MWH$ zBG%}v-MJ-U^)qExJdz4jspyV=&+NBRii1rVQo8oTv~9qxe3zf%)zuauR$4H9Z$xZlAI-5;OwP_yY37E_;TRt9~wG|ay%AiNFB)i?gYWN0I7a|0R$`#S~b^? zICNyuH6|bh`QQA1q&T=+@E^xXt4l2RehE=cBj5s}OMe%{<&SpHDeAR%-hQYY^K9d) zkIy!Jm_0DsZ;hUl=9`J172cRL2oqYHc`~Q05*I)BNpGf#(TlvtxEt6J0^HHPq?!5gPH77x2F9cl5@a zv=f>l$=hE2Gg|kxASATdX68+vwZ}zbw<7aBcMR17PEPYm=I}uwh&MymEaw%*bjrrM z&6JX8U&FURNVtwKbpOW}2E-B2<3;sx!{nma_*Oo3OYLb}yQe?tGEmN^gj;lfN4G;y z1lR`6>_666312^I;#)r&T)|z%^~a8w(%JT=+~_(_(5|SsbfA~$&eFAPX%Ix)_O!YA zwv4wv(! I;RSUfMoY^+5Uy@5=#}h(X?z%+kzRLwfH%1tZ+X4QcJWhUc?l^byegA z&MDVZ^Nv{nhic+>!t&Pv6xGIP$4NVN*o3NcHP)FE>0uVW$sil>oxLX2%ss@1IUhObPv(_KE2{#O%~7>{2c^SbcB#!{&#`y_{}< z4`Yxv>Jr*BG1z?p8CTVy$|D~I+Kbez*i8;uTdvQ9-rx=J@hMTG{oNa?x0Q6rZR66a zbIGOcuCbI9_}W${GTZGZLUC0&$G?}Sa~OXy92qhF+wUYZ`lW4(Ek8NUK9jw}ZlyTg zsO^t4zr!t50_obxcylZxmYy@V=L}a|FK`$}^(GAZd8{qny8&yEvvf&RV6n4aAs3F4 z7bDA`pQXR=*EXoS58WroMn@8RA`^TomEk3#&^LH6#k|vr+6Zc}DXk+ll#6bXkKFPJ zuQwx9r{DRngVIJI9TbaFGfTT%`()C&=h4<1Sadbg#;)Vx+CS0-#*F1xrv$g=INm+8 z8o_^$d8#iYU(GRMzQ?uWJ*<|v-@3tm%S%J%=$Y?jtUp#>!yEf1HkGb!@$S3z{PF+a z3-~I-v3@?6ASKJdBRD0g`KdQi(H@+Ft)&?j^g_6+Zr)xIa)gVRl7PyS{`DeWNZ$W( z;gCSOmgFR=ej3m3g%}$+y^D)90+`vD4Mr%w4crZME{3qh(`)QM?rFPQbKZ6t=)V8% zQ2b=*8A&oNm}S2EH|~5kcBSWuG5kmgt~llr6wi2gW0@M7c8^SH(-(dOG2gEPWOme$ zQ1$w)Z|p1$H1Oe4^u!dWu^(?rVd%%-iLeqikb*lP5mhY;AQt0ys@aXzQq+r zxO~zLZV6@W1>LT~y)`<_+=&VUZ5Ym6cgpeGYt-QrK4Rk`O~pTZselJw>A^rxFyA=* zZ?E+}vlD%OP6o0s!7E;+8%QXzp^&E7HE-#fOvhuE7UxKMH*~Ws-s*59pnrT{ms?<3oOmHJ*&kzQDNy9qzW$| ztZJ}pxkWrb`sr%rk^kf7Gyqa&eVS$*Xq6gK-H2J!$|`cBTn@P;9PZKRU=(?rtF9cA zBK>Nf-C{bnNl=>~wg$ODojALXszXsd01?Ec!tG;F!rv*sw8Pk}?B>zzrjF6yz7+Vk zx$z1@i`FsSys^GVoAgwvvDofpXkrUcw;eSE3HqDH6?S1TR6Ia`nxl2<5=UoGI38JB zG|$^j&+eT2rCy)ij0@ngqYbxp5dhlBTycjW3j5ECPmwly$C_5I$lqN9hZDTr6%u(s z#HyFia9g8vUAASL@NXLl1@&VbxqO(2%(I}@HIQ&A8`goKVD$=?{Q$sf+lIcJvF&HX zxm3)4qY@p(hK#SS+zWHuQIlp)Nx*g+aJi~HyzEI#4$-xK_pKjjF5AJwnI6bXEpN9p z%Dvm*M(rBicW9OqjQ6S(T_eXAtQ4En;hPD4t|o>GXE^=~d(Z)&jY^~(a~=B2;})1OB7ULFalnZa+A*+>^rX3%_W~>Zp6dA6U-a>-rAT0M;-)BX>xU zlqqw-qtk;5x%3QiD{hb`5%B@v~*4Y zefgUCI?tfm23+r>>vCpQM~ss4q2vL5Gep#f9BnuJ+HvwvDssd)bWty~a+1a4f7HgRyD=J?%TEgs02 zrtfQX>OgWg$GC%Z1eMT^BOVu_8U=`!e$J}-4L@_>4KDM^Hf{&#vPTpa_4U!o{*B!8 zy8yGAx4F?N`Xra<$u2l)@MuD7^r1#N{>%AnV2B>`*qFmiuixzpRcx^n7~4{lw7k65 z|5AC75iOUHnAn#6H@7$KKEoRu(Hb=BT%_SAz{9QhW1wZF9qxLX1)e*T&KUhQ8)qbY& zYx>QZNnY>;362aW9|3`5_@r092F~nvE)F6GIzcWKshaR0lD(ZB2X!>;RP|F2)>K z`h|a4(YPm*-Ufx6)>zwS_Qwi9zhxkLWc5~Sm5E4Vd(O$2 zn}xFdo1uie1Jtsiq zv%?N>q2L|mR>;-&9qbciPQ3g;@~=NWnfWWzlAkuHQiHu=P^&F@F$uJvy}N{6Napr2 zfj9etAp_dvPPl;&&O!BHfj8EZ*ziRyd(7xL_gL<2ys^r2T_?tl@q|DTshr5C zxd(Sx$O8jqP6=4l#N9aa_Umi(>e0qwg83njivJA$!}--G-aW(q5>0l4R-(3qwTB;$ z+wGIwE%JD{%^?qOD4^zVJE7bH8Un0TEGntbw!eQS)9cWWR%hQI!t9fJGSY-4>X~n=WB0+e7Z&m$=TqzWCc@Y! zJ;%CT^h&!;bvJQisW#{jRd>Rtwt5?JT8`_W#b4@?f@)JV8nh`+#OrT`&R4CSd^KMP z4Ni!rN@uc!p+B+qy9eORd)EDOe;1C-GrQTKeVVw&LC5mF0dDXM*?xX5I)SqhD*x`` z0HgflDO>`V0tyZ;R{#xJQQ_h8kH>b@_)7p!wEFxSg}a&xZe@cB=2M2;_%yb?Mo-l; zt=;+Re*lVo)c6gPLtRYO1@AS00@60B8k`)WR=j7EZ|z?L5h+q1HRkZxR6UJAR{EY- zK2QURWH-PK8xMJ7Qty$ODdC7*@aqZ1_{(%ZVyF<|{pSeEo%dKX0 z?XF+a_8M?QP|BaLRFC_|OgDJZ2f>s~2OrIm*}KNMIt)lK85q-n+pWa4!Ea73;u8u0uxE+FG{_)wqvjnz2S4*RhBpEC@v6+7TZq1n;gX{lH#~?#Z z_djL!!;R1pyQONKdq3jTUnXu!7`-ixD^6@XsgP-yU9^5sb#`{J(%VDU_{2IGFQ0%U z@(#~B7zKtu<3=6qHYj?t@yGx1@|~9#a4K`aho*UL;XKOA*S7JLm$36KteRE$#?|-1 zKt2Zr_@{@5rYgvvPO^tw9UF5Q1FGh(`BM|T&q;5K=lrk^R!W{Jh))?tG>}5$;2@U7*Zds~89Q1M8jp=anMlNDp z*<@x(Q0pzuR1$@P}irQeHiHNDIeqPzHRfV zml97=6O5xzF`TtyGS*wi`~4r{W&dx2oUsQk@Gkg%ap~C=PkvBvmP6U|avuv_nj-i= zRKNExZ{dvH`v4j5OLIgCLm8I7v*vI5d5vL-$SP~dh91H2a!xA8nuNT$=(Tgx`s@0;+h5;q$u z;T!LAd_O$D{yAhF0@R|=nY+Bu$OmHs>x4>-uD);X~C}Icjb|V zjBNzlHvV`&{OTMxKQ2n@A)=y~L0qK2jLBl!(=NJOaPvRA@_@4U*K4v63A}hnz|Ml8 zrr~8klY{Jfbp4>ltXHv@^3oX|&aMIF9@1-uhtdPN~pz?^y4^MUET}BU+>4u zjrVSX0LC3;5%T&-cvsLFIHg63!`j0|<*IY`_?Zv8<&u69p9kXzs3A-lxq!%gR>>jg zVFEIqX0P*7^7o${0e{G>w{9Ti+*Zx~lMC$j2xwarwOs#b%bAQVN4e&dN}LVu7jmc@ z4P}@s!y_httK&>~QC=XW0|it^tecm!b6X(&s@flz6I(ktsC5U4M+P!$U1vpK=Z~4Cyu0PH1Hv$4$&Sx!VZcxld*b!5hCg}@P~P9)5vssU zKgC78j=}mAY-_2kKZmhA7;DU1=cb+z+GUNfuN-pl)yoSg$eVVcCi2vcH6fg-gxyTE z>+zn;2~L2($>CC@7(lg*0n|bm4~HPg{PNF-V=}aDxtY6ZeGVz7JHNvBliXjNjY}Rb zEzkd8b?Q9-I?f2-Dd&(uV@+-}b3|Ie{^s?{YJ58Ll@Nq6>AUXRygAlH<#r;j zYsP}&5bLQrm%diK@D}ir=WBHM^U}%j(&!6&p%BiycRE!TYu?2NA=#D9r)Ks~ zS{zi(y(h?#dmt2e`ILra1U%1;cN`*yK;viUg-=u0%DqEMvvvR%I}hx<@1ofgF!7H* zRN8nj6Ck2ARrivHL#*{WSU&9La7Oj<9E;tMwF!VRPUM=qTtIAk@Q)Nk3i+;2;|p)D zv4)o=t8|PU5i$=dxgLH07)z56k-A&JaSqtiJ@w0aipk2)yMKYhxAGYPlSdwEz6^rk z)*WOv@{|WHGs^fjM>&AalJFIyX_R{1Q0EA{8Y<6 zAp+}YKgAK^dU1P$p8TEA#P_@Q5)5EJJ zhAJS4cnA3mIm_(qdETVG2mcWw1%F_Olm7IMNQec!gUm-xu)@U~>1#&_we#ZFhX3=P zOGSAH#TXKg`3c+zV$ZDqvOTf;&>C7yeQvJk@K2I}an{S0m(pB*(>kh`X^*4b_5{vP zz;S#%uxL+x{@G^C+-i!m>@UdV$({~*1$pnokq0>}5Qw=dDc^P7y{9T)mdn-lgyHQ5 z@wBlMWA{&U$*&o?^Te54ey)fAft~2+e=e)4pd=UzS<6n~64*Os9fnNDjsdED-%uzt zT+0Jqjv^z06GD`CvLJ}0!h;*B{ZI>;Y&c-z9w5U^HxPvGv;#XqS6ri@KwMMa4fv`q ztO0G*nB#Hav+7S?gBWkNdK}_E0h-o0MxKT&C7BV>+H+i{Q9Ph?D~Eu5JK3RwNmQ!) zre_@S6OeqQ4DY$&RGl->%VkduC8O>am^EoSN^`NNX#EkIYF<-N1h%LU)6T(d;5VY2 z3j+k9%LDcxbop;k@kibOQJN>4-zRSQeQxMLQVqoN^3@*_p#Gmm8>+r^GsMFz7w3C# zKXr4dNBq3)CJ0=N?7EL~D$J(mkZU1(dAkoo43&b1q+Qx<+zSY(GiCY6{vI60wm8Mnm79FuzCnGoJG1OCzSgeDsXk(=H z5=$6lF>**$lX-%h-o^d}IExFz`*-@xPFyu5tt`d2&v(yTWQ{*&2Blz+HKU*a>89{? zerjlTsv2IHrk7MOu8b>jR7SupMaknjSIETr=xi{ka>Co@pLeC{z2a%I=&n zY5ebpYA5j|C=~AfiVmVb?)-Z@1P=!Ck=V~G`tezXzrdCP9?ottZA9cuBYV{jAn;s3{=%^(8ViI%inI?eRP$^2Th! zj5`^*nj3r!KKql#cgo{n;iZUf-?v^2so*BaC~wi2&Vpt>&e zS1*r{pfu#cm?F|n&J0aY^nRT?tTX&9P` z_$r-*YB|%y4Kur7=noV7I_xKjEZ5U0MaZT>+tANWleC($st_YP!6Z@0E(FpAKBG&E zq~QDJ{|})-FnuQ{1(|GVWJGGxT$~o?ww!$ey^x3Un!8a*2NUF=mzh*1!_6XaixA}b zl@;EqbrliPdfgk~sE-mS{BFB#z7IY?TQD^Rx?<*|1DV5Lz}LNc5KA+yv*7DqIvQVS zfng6gOYMDFu4*M*)`KNaRZlL=DZkEVs*bAmlm#%Ga&yhl;Pb<|JHlBD@9K3Ryryjm zt++QuSVo8WEHC;JhIiot=iA9;2#T;#_8$-y2l&C}n1p~(o9H?^C?yPJ7FrM%Mrns+ z_x@zy*OYCadnmpkD9RW-kl{^BLa<&ey@M}b@&_NZ&hh>?KuI$d&WZMbbZiqY8&^o_ zBA*DYSASiDI&M0<+qrB$uI%kH-(=ZJfGLR~5g?`yQI(7P4+m5S0_`=JCkuQ3sWCpe z^kt~bBC1~F2$MNo7wE9Ugs-$O&+9GEEbJsvZaJh#oua=ZfBqcDVOu~OY$&7e=HS$) zAb3GF7EZ2fQrn(HnbY+1lRp%JMNN%$VhddSS$Uc(zO1^kh01&$v__q$W%ZG{=hl}Y rByl}$C1xFJX1&M+UkA@$`F&b)eL=0zK5-uK@9gOdr*i(X`uqO@lueve literal 0 HcmV?d00001 diff --git a/modules/ROOT/nav.adoc b/modules/ROOT/nav.adoc index 11924f04..e3ae28b8 100644 --- a/modules/ROOT/nav.adoc +++ b/modules/ROOT/nav.adoc @@ -11,6 +11,7 @@ ** xref:provisioning-gcp.adoc[Booting on GCP] ** xref:provisioning-hyperv.adoc[Booting on Hyper-V] ** xref:provisioning-ibmcloud.adoc[Booting on IBM Cloud] +** xref:provisioning-applehv.adoc[Booting on macOS] ** xref:provisioning-kubevirt.adoc[Booting on KubeVirt] ** xref:provisioning-libvirt.adoc[Booting on libvirt] ** xref:provisioning-openstack.adoc[Booting on OpenStack] diff --git a/modules/ROOT/pages/provisioning-applehv.adoc b/modules/ROOT/pages/provisioning-applehv.adoc new file mode 100644 index 00000000..c252c993 --- /dev/null +++ b/modules/ROOT/pages/provisioning-applehv.adoc @@ -0,0 +1,57 @@ += Provisioning Fedora CoreOS on AppleHV + +This guide shows how to provision new Fedora CoreOS (FCOS) instances on macOS using https://github.com/crc-org/vfkit[vfkit]. + + +== Prerequisites + +Before provisioning an FCOS machine, you must have an Ignition configuration file containing your customizations. If you do not have one, see xref:producing-ign.adoc[Producing an Ignition File]. + +You will also need to build or acquire https://github.com/crc-org/vfkit[vfkit]. Prebuilt binaries are also available from its https://github.com/crc-org/vfkit/releases/tag/v0.6.0[releases] page. Vfkit, like QEMU, has many options which are outside the scope of this provisioning example. Please consider reading their https://github.com/crc-org/vfkit/tree/main/doc[documentation]. + +== Booting a new VM on macOS + +This section shows how to boot a new VM with vfkit. Vfkit is known to work with both Intel and Apple Silicon based Macs. + +=== Fetching the AppleHV image + +Fetch the latest image suitable for your target stream (or https://fedoraproject.org/coreos/download/[download and verify] it from the web). Remember to download the appropriate image based on the architecture of your Mac. Once downloaded, you will also need to decompress the image. + +=== Setting up a new VM + +Vfkit is not a stateful virtual machine framework. You simply need to run the vfkit binary to start a virtual machine. The following command line will launch a VM with: + +* 2 virtual CPUs +* 2 GB of memory +* a network device that will receive a IP address from Vfit +* a GUI console with keyboard and mouse support + +.Launching FCOS with Vfkit +[source, bash] +---- +IGNITION_CONFIG="/path/to/example.ign" +IMAGE="/path/to/image.qcow2" + +./vfkit --cpus 2 --memory 2048 \ + --bootloader efi,variable-store=efi-variable-store,create \ + --device virtio-blk,path=${IMAGE} \ + --device virtio-net,nat \ + --ignition ${IGNITION_CONFIG} \ + --device virtio-input,keyboard \ + --device virtio-input,pointing \ + --device virtio-gpu,width=800,height=600 \ + --gui +---- + +Note: The AppleHV hypervisor does not allow you to see early boot and kernel messages. While you will see a GRUB boot menu, you will not see anything until later in the boot. + +=== Exploring the OS + +image::vfkit.png[Vfkit GUI] + +When FCOS is completed booting, you will see the IP address of the VM displayed in the GUI window. Vfkit will lease an address in the `192.168.64.0/24` network. At this point, you can either choose to login or SSH to the VM. Unlike some other virtualization providers, you can SSH to the virtual machine from the host. + +[source, bash] +---- +ssh core@192.168.64.5 +----