<div dir="ltr"><div>Hi Robert!</div><div><br></div><div>The Deckhand client does not have the ability to bypass Keystone authentication; it was designed as a component of the full Airship integration. Are you attempting to use Deckhand without Keystone authentication merely for demonstration purposes?<br></div><div><br></div><div>When submitting documents to Deckhand buckets, documents must be presented as a <a href="https://airship-deckhand.readthedocs.io/en/latest/operators/api_ref.html#put-buckets-bucket-name-documents">multi-document YAML body</a>. This is because each addition of new documents to a bucket creates a new "revision". When documents from previous revisions are excluded from the most recently-submitted revision, they are only accessible from previous revisions. The common approach to achieve a single file containing all of your documents is to store them in a repository like <a href="https://github.com/openstack/airship-treasuremap">airship-treasuremap</a> with corresponding global/ site/ and type/ directories. Using <a href="https://airship-pegleg.readthedocs.io/en/latest/cli/cli.html#collect">Pegleg's collect command</a>, you can combine all of the documents into a single, flat file and submit to Deckhand for rendering; however, the aforementioned approach requires certain documents to be present (e.g. a site definition) that would not be useful for operating with Armada and Deckhand alone. <br></div><div><br></div><div>Lastly, documents are rendered (i.e. layered with substitution) when they are retrieved from the<a href="https://airshipit.readthedocs.io/projects/deckhand/en/latest/operators/api_ref.html#get-revisions-revision-id-rendered-documents"> /revisions/{revision_id}/rendered-documents</a> endpoint.</div><div><br></div><div>Hopefully the above information is enough to get you started. Feel free to reply or join #airshipit on Freenode IRC with any additional questions!</div><div><br></div><div>Regards,</div><div>Drew Walters<br></div></div><br><div class="gmail_quote"><div dir="ltr">On Sun, Jan 6, 2019 at 11:12 PM 최태일님 <<a href="mailto:taeil.choi@sk.com">taeil.choi@sk.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">





<div lang="KO">
<div class="gmail-m_5507089300203249966WordSection1">
<p class="MsoNormal"><span lang="EN-US">*backgroud info: My team is currently only using Armada among many airship projects, and trying to leverage Deckhand as well.<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Hi all,<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">I have questions regarding Deckhand usage.<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">My team has a lot of armada manifests for many sites as following and we want to use Deckhand’s layering feature to manage the manifests efficiently.<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">- global.yaml<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">- site1.yaml<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">- site2.yaml<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">  …<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">I’ve looked at the Deckhand documentation and it’s not clear how to use that functionality.<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Q1. Deckhand standalone usage<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">In the installation document (<a href="https://airshipit.readthedocs.io/projects/deckhand/en/latest/users/getting-started.html#manual-installation" target="_blank">https://airshipit.readthedocs.io/projects/deckhand/en/latest/users/getting-started.html#manual-installation</a>),<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">I saw a “development mode”, which doesn’t require Keystone authentication. However, when I looked at the Operator guide (<a href="https://airshipit.readthedocs.io/projects/deckhand/en/latest/operators/api_client.html" target="_blank">https://airshipit.readthedocs.io/projects/deckhand/en/latest/operators/api_client.html</a>), I couldn’t
 see how I can use Deckhand client without Keystone auth.  Is it even possible?<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Q2. Layering<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">As I mentioned above, my team have a lot of armada manifest files for various sites. How can I upload multiple manifests (Eg, global & site1) to the bucket and perform layering on those documents?<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Should I merge multiple files into one large string and upload it to the bucket?  If it’s true, does the bucket update automatically trigger rendering process or should I explicitly call some rendering function??<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Can anyone give an example code?<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Any help would be appreciated.<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US"><u></u> <u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Regards,<u></u><u></u></span></p>
<p class="MsoNormal"><span lang="EN-US">Robert Choi<u></u><u></u></span></p>
</div>
</div>

_______________________________________________<br>
Airship-discuss mailing list<br>
<a href="mailto:Airship-discuss@lists.airshipit.org" target="_blank">Airship-discuss@lists.airshipit.org</a><br>
<a href="http://lists.airshipit.org/cgi-bin/mailman/listinfo/airship-discuss" rel="noreferrer" target="_blank">http://lists.airshipit.org/cgi-bin/mailman/listinfo/airship-discuss</a></blockquote></div>