From 28573af6bdb2f987a832facd8eecc9cfd2eba758 Mon Sep 17 00:00:00 2001 From: Jon Oliver Date: Tue, 26 Sep 2023 16:46:45 -0400 Subject: [PATCH] docs: add docs for pantheon deployment workflow --- docs/_assets/pantheon-development-mode.png | Bin 0 -> 11064 bytes docs/deployment.md | 61 ++++++++++++++++++++- 2 files changed, 58 insertions(+), 3 deletions(-) create mode 100644 docs/_assets/pantheon-development-mode.png diff --git a/docs/_assets/pantheon-development-mode.png b/docs/_assets/pantheon-development-mode.png new file mode 100644 index 0000000000000000000000000000000000000000..9871dee709eac05714a5af46db4ff7bdbc294e0a GIT binary patch literal 11064 zcmbulbwE_z+BZD(&>%=R2+|B8A>AM)pn{Y%Lk~H0cL~ysG)RdOQqtWjokMqbe8YXt zbB;Xk_x|<5V)mN7*1CFKd+qB-n3{?lHU=36006*Nke5~m01#pDzB&*U{(0v#tp@;L z)Ptp@)D)zoXw)3+%)r*B0Dyd0LK2#$#uQQTa1(zGa4&;QA-V9!cB-6eM^d+UqVB++6x}1Tl`peZ1&D zB;wJ!wYgf8A(Zcr7{(cmKGWZ-)c}0O*X$V(0X-^3S+VU;vxQbH;&-KmbAYR!@lD)3 z)zIg)+17qtp|7bX%o*=x70h!s0Y(@pQ!VHXRDDYRLAhQT-v zB@6-%aXIBDU(`?{;?{#zt3L8S#dXf_3otH7W<7nCZba2BrdjpE*mjbz5QsE|K}q`3 zJ^XUaw}?5>M25v7U;ai*V<1*(J)yAs`AxBBjieYqpO9_1V_=nIp;ju@Qz1%N;lZnw z*znt98Hwg`H>9WE%@yy}D?XNKvA&AJdHZW9WnRpnBlS;w7wcIU>>5p}yW{zCC%1tN z2ShfIE;9>1@8Ff=XF@B}4Zn1K@*HR|IQ?TNGwLYK(;h$I0f1UwoVy2+R2-G$CpFNI zFm%*_!k3DP)Th|GQJ{tGkULE6Ba3n6h)%b8rHt-O3KrT+G&w-m{=o{qn_O018s6>I zH_mHBfNfBb2G=f(1j+tN5bz6kTohKjaX5|ma|)+iH;!jBt&!0PZ3ZqBsyJ$EpB`01%fk5tNyrYa#scM^r)kS{y z6MF<<&tEQ^{KW6w2cRb)7Y})f7DGDd8!b`~;n!da8pahA6mdf}hIqg;2}F71-khf+ zLPbE9;J$1xHNF!bC$b+vy#S#cG&NjaKvR%tJ5VVYTuEh(I_#gqg^3fCyA)Ij7z%b= z@`MuTV!UgUTXesm^F(UKbZxI#G(@IR1X6;et??L_Ljvi;$OJ>r0z;N4z19;TDKJc_x`^0B?;v(f@bnd*it( zYir@RzIy)bKNCOT8mSs`8t)rjS5n&xP*9pjJ9eVLp4fxyR_mhbMCycQQFNKgiTNYD zVc!q`Kvg{jG6Ry9Fb^6ICPuwy{f!8O9eW z@;>`P&>kkd%)M;3j9^4?$XFF4pr}rt@<~`>G>>=ey*hJoqEpIA@`;LqLa%(UGB`6% z4IHIjJO;`yRTNRo>e(`3{YveIpsg}5T~22}BSzDbtM=TCkXn&WMs`ZNxIp)_aK5Kz z0m}?ab%I-8X+nR(c7h#q%Ujx#R`eN=PMNK}9Q;pT4a&`81B4zFd z&RS6=W)(!`iN!UqcPpp)z7uajoq0|H&YAAbSKgjzLiGHHO}WzH4huo&*&El;IZHlHnTS; z91;+P<#2ql$|o;w&~qm2pcj}$Xt>YCEswNUAQckN& zz%eQ(DH#?KeZcEJ3qvf@EizQ{KJ0VS8uDne6!K1zRnp(2A|OUmo+ypTT5^7J+!T`J z0g$$#y7AFSyhR_cGT$6{+EU2K%$CT!X8ud-PEdWK;EeD@W7ka;N@v>)-OT5)<>+Ta zao`l&`tGmo7&Q(xir-mke}J)d8niIW&b3^JI)jCn@&>(q9`FEgO?K@K|Ch9i8OvH8 z+pJl=S<}7lx%-pKL-})ookOFVOY6HGq-qb5C}F|OYvG0_5`6`IF?VMVa(Bl@)~2jW zlIsIcoU4;+Hf``1`Y#jBF3nFCG@9wX_qO2%Gk7>{Q%f^#S<=aJCUQ62xcr<(`j?ICv1hTYbUL|3uOo7C#on$5pRebiL&I|7(1U)s$8|9uWLF4f12uT_!Ls-J)1H6PMCV$Wgf8b z$zWh#^-zgf#f|oW(3$`%&%H1)4+rBm(6o&o+zNgQrr%uJe6wjx3L$k)2^`297^ic7 z{iEpFD={nZ+rr8Bx-@%3F2nP&A`IvW6!DT{L1VI{*fxpND?~^8D4}$eY>ZFQl_Z?yKx%oe7DuiCt-zC z_N+|V;MyuvPaiUW?F`vYJvu#_SULA5KG9S5bMVVsymOB^eY#-WOzgeT+zM$g$6mm2 z3z~@730DknwqCJqybHL+%@>QbQJnhKJY{-3&tAv=nf<)R-A+XF%iDCF*#?`TnycN& z-JqF;eXT~=`!EfKPL(m0%b~ro%CRmz#)g`mEA_j+GmW6D+UaoagjNvHvdr z{X4`N*RI^pYK0F;j)-DYV9V!Q)t>?v1IniI4H5xHv9qJ~ysUjnT#xbTt;j@eLZz2)yXGKXf*ITZe`vzA> zSsIy1C*&vZTI`_^GaCDB*y>G^S4BsKEE?vW+O_eyRm23-{mEsu&2#Uf{iv0}$(gAA zZwqglT-_IhDL^+TQfncjv28Ka)VN+o-j=r%=k-2Ly~H<3V-<-8Y0W|29>R%&FBsS4 z1qjLj{x|~9P<(6O0Mwq0%;z8h#%_A4Jle8*_x;fk@57j`56~SEvis0{llcIFIU;@f zPRXB@WY-U0Fi)fXjE)Wm{l-;2*@Fd3wHSpDe&^ks=2tBV@R>F-xKHxBcSObb-7nUK1)?7x@8zlqRUI62u1adNu4x^lSkaM(GR zbAki~1v$C6Ik~yn;WOAB-E5r_wP4MPvx%l;*-J;0a*pBVli~5GS>z3i_v^f**lpAl9$9?_W(E1G%K6MAzB*dueeoBtyvgNboIf7yfd42(GK%52r&+ z`R4=(_;`Oc`4|9>os+ALP1*ME(h0F2h!*QvOdQ8kudIe7K)ah39*04=?h$8`1kO- zQZWi04dUM|1^*+-Fjg5i(O+`n`Q0EhbR8d$sy`CHC(^eAYG#p8^_Vyl4Jb1!CNcbx zZOq^Vc%(`rW&T!(MhqeB@W%6-<|8G!>EQ%O-ojs1a^68QT#{+6InO`o^O3xkK{TcfLmr* z?$u)zcn~Rh`n5?T#8C)HUb=iC7jge~eZAkJ=jG*vvJd{MN6z)ZmmFjy{k6k1uH;>X ze!0i_Ub)ZxUAaMvx2d}2Qw?P4Y(eC$t*zOErS`dtL)hF(@29j+L4S(X5Z}CcQ*Jd; z9&IJ*?Ci|w!3@eoe{1@_7uoy%)|Ip4rOVESrKKf{+dG1Na!JqSjsgNt2 zuAhELUXW)!{Yyo~k#uUp2!R)itpR$qwsVb(lAgWNKY=5HX74%-$XM@roS(Q31 ztXL4y(IZKDx|I2TYnH!C;y|CUFzBuO_@*r+x2veT(y)CtTOwe3LgLqaxcEytUpWd| zl{608`Dh%^HobfmHU1*{UkPkVnTKpeEW_c9;uhh;%NkV62XsVtncSvsgAyOd5k7_a z0yP;CBsG8%AH&2&5yzEyqB@|W;_n#|*%ib=%k|(iU@dqreziJ~w(m_MD)HXZ}a`TODG*a9VLGQ)1q<#OXECvg&k;=}ej-Di-V+54YxH~(rgeK!Ec358+70!!U9^@%(`jHq)Fvn*q@~&m zxgAQ)I3oThb}X`xS4i!$y7fHR5mWHF4lTzAUc|rdT0<|qIeVF_%&hb8xU)ZsEPe8j z48+B=bzkDQa%>d-O9oQ-ZsN=h$p8HJZqOuxM{O`n(DK*w+8Nu1%NQ!dx86^0>en-m zyZ2T;sdBWmm3I6m&UaJA%|NgivAepL+h3|vf9}p4kd4X^>-`!OyT7r$TupKn@i?>o z+W7tM=5)efZ^o|WH0}O)SWKss#Kx?l@lQIx(h;*sn(dEbA3ovDXwfT++EH2Z&hoFv zLocu2^?tQ)xjl27v8mOw{;@W&a(d!&lUnVqW3UeAXfG9vb=YkjOloF7uJW>s(*d5T zj2Cjd(%Q5V`+EY+^Jjigm>=!T);pHJncng2YwBYutyB2KSkKvf(dKnN=Ne@?2fxgb z+chqUUhh8tJJ%u~UP_g%7UIRVi^TSYH&T^)8`3T?m@aqVZX zP2c`itYQ7tW4~$QaIB%Mc3#NEEhh!m73C;)caaNQ733KbFox-Tk&B_)ZN9s*s@?h8 zPt^C>D9N0$3ufy{CJe14Ho+A+`6vb~Om_$uJ9zr47R%LoXR=CP?RfzoM2LT0yh zTvd#cwF|$G!lSzGhhabOZ43bMI8nzIa=zfxV%Ny1l)Om1*RbDg+jRQJaaioWvEgjm z>RxAQ!6420YZ#28-}Ie<*LRQg4A%lJ*Rt<_9N<1^O7p(jbS#@TTigFOuHwxbD4TI* z0-68Cv%RqkceHKu<(gwRg<~Wqf5uPNipH;lI{_GUh;(Xq$aT$nPNOn=g<0N~UwJmt zQp_`_yx?A*zZ^9&B){RYp5$`9yIgO8dvAD9V^q+Z+u$+^!2==k++0LUjh-mz_(5>0W13$F?li*RUr< z@2P54tOom)B4==v`RAPWTG6OanwZ_Cp~W0cC+hq4xwX*kvf3Y0W@&?QR?~gR^Pb1b z2L5ZnHMpG?T8g=@-Y=PFx)mgxm)KZmzT2;mKQs$& z7~7>F;c|qF(PNl*BiMpH=bu*(5W#6okLr z^L0YsW3Z~ig2E|6&&u<&Ps_%aY}Otg!c*O9Nm+rYgK(IDWMl5}B;$Di?P9MOZ=irA zIi1_e6LVK|R^yMo%Lzcf^>mB&XfOJM+r23u9r(&d&6}Ese%(RD`jgK!1rH?=WJxz8JG9|}!!fMB zHmWTdIv&Pby}-uPYSW*rJ^^a{-LUtgbYJ|El++8GQs@`vab-Z-Xn|)9v_p#4cE*UR z-@CE-)1YN~dE-&v9e>88q%2y9P)zg#kGV*zAd=znm)A6>DSHRSLG};)vI@j0~5I0p_j;$z6}iQJ=PN z=E3;&We67GiRg=JKe1aS#S9b{b<3;ZEowMGjMy6}!0*50oNEo;0I`TclwapAW0Udr z7~F8yEh4s%ERhqp_j|I8MsPN7pb&@QC+}<2q*(+(+D+5gzBnIUVM zzFB7gM%k48*eYqJmq2TkW$X!_@ef8^vZKpf1$sx4 ztk z0SS7214bfG0@K;*7X9@(vsvr*x=D|xhDYqPm(o|-pG*82f$9>YUmDIp=ojMs@DfD5 zt}cEnf6N^nptrr`?)$ji`XsS{T}ekd(y_KG1s$s~hs2OZlUrCz6O~}XMS`y~RE7Xb z#NT(NiNgl=7KN-}(puEOec(O}GNm;Mz{4HrGu}+5a|nZV3gCaCk#ik97` zHT2_8hfp|#Uf&!K-+r?A+?^QQBl;^KFSyos^r>tviK%~mhLysx#ir94a`K3dBy2Dg ze_bKRz9f;OqJ{~6tV%%!rgZ}Om5jcP3iP%eVEuvld{f4iQ`~(YavUgpU;_Kurrm=U zLPXT$7w-nm1J7tDZ8OnQ3-{u5Q@JhiF%9G;kE%JzlEg_~r$r#_@@8(0JZGXrOQ(ZQ zrCCL~%c2OX%#PrP;n{6Z@Xp-7Mb|Kd2_JP22nRFT9!ko=#1yQWI3?+TZ(1XifIaY& z%mywS7#fG{Pw*-=OO@jC>n9{mPk|GuS$0Yks+3@XuWC+MQwK7>knoP)}XxIlfZ{u(!`LXG-eDMK|W3z1LnVuw5 zAe>q$&-C4pD3?ix?JyX2cKJwhvds9HJ$^9Wd**J@0j9Erz`T(U+7{uf4$2Fdq@eHOn&^>qJYsdBwEe>%D?Fq{WS;K&a;GvtOm3&^ z!*UC#k&o@+?JiXO53+>^DY`jflNt%CY3plAf#5JGD|H(YI{_I^jX<^V0ZA_V0N$iP z)n{3Gu3+(1cO_4u?WIs!WE3VtUaFU=awk3~WJG#YcZKQFY&18@2LzH45TEzOOY}g8 zy(aodCW=_5dxs~>@wLA@>cXC37-pK0mv{46&wofvo1&klg8dlo1$Qq2qM(i=2W zIIccf`n8+~W63u*QyHTHgtW5iX#{A{11N-w!QugfqlAjx(j20T+7R2uai)DNv2wxuyNQ3 z3=h59Qu(DpP%v)y@Fpp*2*>bWhC9-llNQI4uZE z?(-&njg$cMDnm!$2nmG;;9yBe}l6n$u`3COIBKeGSLBdbC%v>iZVb z^4!;Xv^8DH(NxE6A0zBN0`(!Yct^9L?LBxIsz&Intx!)|Rb}S2(cpBT__eT8-$-Mfl zlF~*M!@N{3eBo|kyO+iIi3$R!+sEYQloQf5#Lk+rOcQNscFj{(c*k`FL;UuO;uR^M zhs0RXCd`kXMLumZR5hqtRVdJHuy8!|hk3RehSV&(idG014g~&A7G?XktM;)1et<9~ zNPWU>4FW}*e+t0((7=p)*l5+RK{tTM7z&XFZfLcbSGZaX#}0wf&f*n7BX{v5 zW-CK_){&%)Rznrm8G=BF336;QW$+LlWG%bj(Q)daGnh~3T*6M_{kBs(#}jKe=b#-- z6XRj2*nC9))37&6c~&=y7&#XSY^Zv+Ae1oMAsrGEjYXZQFD?qVJp#T32SNusuH#~X zv~Y#a_=##jxTzvMf zeaT=KT9YLF6^Cyn!4bbrjBFfEqf;9+ATcOd$8?EdsVf~Kv8~vBiDJi!ive8HGFB|LXupzWWAkYwr(nqFImLp z`{ul!DfTO38K~}Gi86m;=K$T$_^_518AXihif#;dSPu_Fbyzr>>?2R>mxlU~R9Wa% zWeurRHFE}_*kHDc!Nw7i7j!l~2?DyA3tnaOxBnPN9x$&~AB zItVxO&O>`Ju>*(_AbnwOXZ%#OWM)?BHmOGisV3c>ew8mWqx}n?35EY+fV5K&A!Vvk zM{!0L@Zb-}<7TuTY$}hQTyesmlFi6t7UN*1x|XoBd^P#!yM#7Gxw-k@KIxLx-pbA?VhJ?&~@pw=?&9Yv>EC@-&=5=2%@!#0;AAIocK8MrxFeoB`jgErl?K&7ZFT;3()8PLuMM@uu46>0FwxvunpQ$Mxter1XPQj(NZO)ZbPN`dp zC+B@mpXspn?7O{3DSt=K=%-G+8?4-*nZbm@)z)8s3L_2kzk9N=yFm&C{AXn8ltMM$ zk-Rrf?vFH9LJRfEMe@aC(wn5M{-zMqly6t6k^DMq`YWEDvJ3BIVAShAuKQuawMhMUi1-EysDQMT6X8SJR8d|#6%attB%@Zf>^QdTBrWu}-|Ls48(1*@PI(X@n(2%9{OoFDDM|}n@?5sMe$-QQ0Ja!sa zd$$<)O%x$>#59J-=60+I*(L$t9QY$HNFmZ(;*Hx|UW80RJslmL(d)@fR}S~rYq4o_ zh1>I)u@(z5*`Lu5IHJ%A7&T8sE!P#9#3_5XnpmH}@~Np;M}~k0s386Am)Cy*Q+qTz*hpRMif89rQ>X7l09yRxDLWPf7tVID&uw8i_D1w8Q$ zj%*?#Am}?x)Y=*FdtTVz$I{>~ZWQ7wx6-RnD!^qnf>GMZOOD`NKVS?ppJ~q4%-0;6*S)?8z zE%FaQ2`N+llSfF)FE~_F7_CYAcg;IgoEz@!UIFHWNAl&VzzI0#^{G9QD-K>YSM5?L zeuQe#IKv4P)4vIREY|}D#jT?F?2!t^aHvL=vY4Cjkz6Kl4C)g^o#n9#58=BdpOEuN zE`|pTD)N*1BXf#x!3k){m0&%JVwwjG$|U{&$+VnZr6nb^aNtK{Sog8ne1W{r{tec_ zVaJ9r0;U(r`96#5E5S1L14OidKt*|mJyHC&r|XpArxK)9;##rUCxqsLi=XaUH%tS6yOG!1qA?p ejQ*L(EZ!3q%-S+Gj1WDb_X;v9(&dsL{Qp0@rv|40 literal 0 HcmV?d00001 diff --git a/docs/deployment.md b/docs/deployment.md index daf4e61..ea4ace9 100644 --- a/docs/deployment.md +++ b/docs/deployment.md @@ -1,4 +1,59 @@ -Deployment -============================ +# Deployment -**TBD** +## Pantheon + +This repo includes a [Github workflow for deployment to Pantheon](../.github/workflows/deploy.pantheon.yml). +When enabled and configurated, this workflow will deploy to Pantheon when commits are added to the `main` branch. This workflow is disabled by default. See instructions below for configuration. + +### Deployment workflow +Pantheon maintains its own git remote containing the WordPress core files. To deploy, we: +1. Build our theme artifacts +1. Fetch the Pantheon remote repo +1. Copy our theme artifacts into the appropriate locations in the Pantheon codebase +1. Commit the changes to the Pantheon repo +1. Push to the Pantheon remote + +### Site setup + +1. See these instructions to [add a site to your Pantheon account](https://docs.pantheon.io/guides/getstarted/addsite). +1. Visit your Pantheon [site dashboard](https://docs.pantheon.io/guides/account-mgmt/workspace-sites-teams/sites#site-dashboard) and make sure your site's Development Mode is set to Git (it will likely be set to SFTP by default). +![Pantheon Development Mode](_assets/pantheon-development-mode.png) +1. Click the "Clone with Git" button, follow the instructions to clone the repo locally. +1. In the cloned repo, open the `wp-config.php` file. +1. At the top of the file, directly under the `.drush.in:2222`, where `` is a unique value for your site. +1. After running the above command, you should be prompted to accept the server's fingerprint. Type `yes` and press enter. +1. This will add an entry into your `~/.ssh/known_hosts` file. You will likely see a message that `shell request failed on channel 0`, this can be ignored. +1. Open the file at `~/.ssh/known_hosts`. +1. In the file, locate the line that contains a server address matching `PRODUCTION_REPO`. Copy this entire line and use it as the value for `KNOWN_HOSTS`. \ No newline at end of file