<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<style>
<!--
@font-face
        {font-family:"Cambria Math"}
@font-face
        {font-family:Calibri}
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif}
a:link, span.MsoHyperlink
        {color:blue;
        text-decoration:underline}
a:visited, span.MsoHyperlinkFollowed
        {color:purple;
        text-decoration:underline}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
        {margin-top:0in;
        margin-right:0in;
        margin-bottom:0in;
        margin-left:.5in;
        margin-bottom:.0001pt;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif}
p.msonormal0, li.msonormal0, div.msonormal0
        {margin-right:0in;
        margin-left:0in;
        font-size:11.0pt;
        font-family:"Calibri",sans-serif}
span.EmailStyle18
        {font-family:"Calibri",sans-serif;
        color:windowtext}
span.EmailStyle20
        {font-family:"Calibri",sans-serif;
        color:windowtext}
span.SpellE
        {}
.MsoChpDefault
        {font-size:10.0pt}
@page WordSection1
        {margin:1.0in 1.0in 1.0in 1.0in}
div.WordSection1
        {}
-->
</style><style type="text/css" id="owaParaStyle"></style>
</head>
<body lang="EN-US" link="blue" vlink="purple" style="" fpstyle="1" ocsi="0">
<div style="direction: ltr;font-family: Tahoma;color: #000000;font-size: 10pt;">
<div class="WordSection1">
<p class="MsoNormal"><span style="">Thanks David.</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">We’ll discuss this in our upcoming docs meeting and will get back to you if we have further questions.</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">-- Mike</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<div>
<div style="border:none; border-top:solid #E1E1E1 1.0pt; padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><a name="_MailOriginal"></a><a name="_____replyseparator"></a><span style=""><b><span style="">From:</span></b></span><span style=""><span style=""> Sullivan, David <David.Sullivan@windriver.com>
<br>
<b>Sent:</b> Friday, August 2, 2019 1:37 PM<br>
<b>To:</b> starlingx-discuss@lists.starlingx.io; Tullis, Michael L <michael.l.tullis@intel.com><br>
<b>Subject:</b> [DOCS] Ability to specify custom certificates for the <span class="SpellE">
kubernetes</span> root CA</span></span></p>
</div>
</div>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style=""><span style="color:black">As part of this Launchpad there are changes that can impact documentation. Let me know if you require further details.</span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black"> </span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black">Thanks,</span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black"> </span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black">David </span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black"> </span></span></p>
<p class="MsoNormal"><span style=""><span style="color:black">---</span></span></p>
<p class="MsoNormal"><span style="">Ability to specify custom certificates for the
<span class="SpellE">kubernetes</span> root CA</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">This change allows the administrator to specify the certificate and key for the
<span class="SpellE">kubernetes</span> root CA. Additionally the administrator can also provide values to add to the
<span class="SpellE">kubernetes</span> <span class="SpellE">apiserver</span> certificate Subject Alternative Name list.
</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">IMPORTANT: The default length for the generated
<span class="SpellE">kubernetes</span> root CA certificate is 10 years. Replacing the root CA certificate is an involved process so the custom certificate expiry should be as long as possible. We recommend ensuring root CA certificate has an expiry of at least
 5-10 years.</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">These changes must be made via the ansible bootstrap playbook. Three new optional parameters are provided.</span></p>
<p class="MsoNormal"><span style="">k8s_root_ca_cert</span></p>
<p class="MsoNormal"><span style="">k8s_root_ca_key</span></p>
<p class="MsoNormal"><span style=""><span class="SpellE">apiserver_cert_sans</span></span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">k8s_root_ca_cert and k8s_root_ca_key must specify the full path to the certificate and key respectively. The root CA certificate must be in PEM format. These two values must be provided as a pair. The playbook will not proceed
 if only one value is provided.</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">The <span class="SpellE">apiserver_cert_sans</span> parameter can be used to specify a list of Subject Alternative Name entries that will be added to the
<span class="SpellE">kubernetes</span> <span class="SpellE">apiserver</span> certificate. Each entry in the list must be an IP address or domain name.</span></p>
<p class="MsoNormal"><span style=""><span class="SpellE">eg</span></span></p>
<p class="MsoNormal"><span style=""><span class="SpellE">apiserver_cert_sans</span>:</span></p>
<p class="MsoNormal"><span style="">  - <span class="SpellE">hostname.domain</span></span></p>
<p class="MsoNormal"><span style="">  - 198.51.100.75</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">Reviews:</span></p>
<p class="MsoNormal"><span style=""></span><a href="https://review.opendev.org/#/c/671561" target="_blank" rel="noopener noreferrer"><span style="">https://review.opendev.org/#/c/671561</span><span style=""></span></a><span style="">
</span></p>
<p class="MsoNormal"><span style=""></span><a href="https://review.opendev.org/#/c/671559" target="_blank" rel="noopener noreferrer"><span style="">https://review.opendev.org/#/c/671559</span><span style=""></span></a><span style="">
</span></p>
<p class="MsoNormal"><span style=""> </span></p>
<p class="MsoNormal"><span style="">Launchpad:</span></p>
<p class="MsoNormal"><span style=""></span><a href="https://bugs.launchpad.net/starlingx/+bug/1837079" target="_blank" rel="noopener noreferrer"><span style="">https://bugs.launchpad.net/starlingx/+bug/1837079</span><span style=""></span></a><span style=""></span></p>
</div>
</div>
</body>
</html>