<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Certificates on Eric Daly&#39;s Blog</title>
    <link>https://blog.dalydays.com/tags/certificates/</link>
    <description>Recent content in Certificates on Eric Daly&#39;s Blog</description>
    <generator>Hugo -- gohugo.io</generator>
    <language>en</language>
    <lastBuildDate>Tue, 19 Nov 2024 00:00:00 +0000</lastBuildDate><atom:link href="https://blog.dalydays.com/tags/certificates/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>Kubernetes Homelab Series Part 4 - Certificates With cert-manager and Let&#39;s Encrypt</title>
      <link>https://blog.dalydays.com/post/kubernetes-homelab-series-part-4-certificates-with-cert-manager-and-lets-encrypt/</link>
      <pubDate>Tue, 19 Nov 2024 00:00:00 +0000</pubDate>
      
      <guid>https://blog.dalydays.com/post/kubernetes-homelab-series-part-4-certificates-with-cert-manager-and-lets-encrypt/</guid>
      <description>A look into managing TLS certificates with cert-manager and Let&amp;rsquo;s Encrypt, avoiding manual renewals.</description>
      <content:encoded><![CDATA[<h1 id="what-is-cert-manager">What is cert-manager?</h1>
<p><a href="https://cert-manager.io/">https://cert-manager.io/</a><br>
cert-manager is a certificate controller for Kubernetes which is capable of handling all your certificate needs. This of course includes acquiring and automatically renewing certificates from Let&rsquo;s Encrypt, but it can also be used as a local CA (certificate authority) for private certificates between services, etc.</p>
<h1 id="installationsetup">Installation/Setup</h1>
<p><a href="https://cert-manager.io/docs/">https://cert-manager.io/docs/</a><br>
I run piHole internally on my network and also use DNS challenge for internal only hostnames. This means when I request a new certificate and cert-manager attempts to look up the DNS challenge record, it won&rsquo;t be able to query it through my piHole.</p>
<p>The solution is to configure cert-manager to specifically use public DNS servers to do the lookup, and that is done by setting <code>dns01-recursive-nameservers</code> and <code>dns01-recursive-nameservers-only</code>.</p>
<p>For that reason, I don&rsquo;t use the &ldquo;Default static install&rdquo; method by just installing the manifest using kubectl. Instead, I use the Helm chart so that I can apply those overrides during the installation.</p>
<p>If you don&rsquo;t need to override the nameservers used for DNS challenge, I would recommend using their <code>Default static install method</code>: <a href="https://cert-manager.io/docs/installation/#default-static-install">https://cert-manager.io/docs/installation/#default-static-install</a></p>
<p>If you&rsquo;re still with me and want to apply using the Helm chart, follow along!</p>
<ul>
<li>Make sure you have Helm version 3 or later: <a href="https://helm.sh/docs/intro/install/">https://helm.sh/docs/intro/install/</a></li>
<li>Add the helm repo:
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">helm repo add jetstack https://charts.jetstack.io --force-update
</span></span></code></pre></div></li>
<li>Install the Helm chart. Note the <code>extraArgs</code> for DNS nameserver settings:
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-sh" data-lang="sh"><span class="line"><span class="cl">helm install <span class="se">\
</span></span></span><span class="line"><span class="cl"><span class="se"></span>  cert-manager jetstack/cert-manager <span class="se">\
</span></span></span><span class="line"><span class="cl"><span class="se"></span>  --namespace cert-manager <span class="se">\
</span></span></span><span class="line"><span class="cl"><span class="se"></span>  --create-namespace <span class="se">\
</span></span></span><span class="line"><span class="cl"><span class="se"></span>  --version v1.16.1 <span class="se">\
</span></span></span><span class="line"><span class="cl"><span class="se"></span>  --set crds.enabled<span class="o">=</span><span class="nb">true</span>
</span></span><span class="line"><span class="cl">  --set <span class="s1">&#39;extraArgs={--dns01-recursive-nameservers-only,--dns01-recursive-nameservers=8.8.8.8:53\,1.1.1.1:53}&#39;</span>
</span></span></code></pre></div><ul>
<li>If you&rsquo;re doing anything fancy on your network like me, double check that your Kubernetes nodes running cert-manager are able to reach the dns01-recursive-nameservers on port 53</li>
</ul>
</li>
<li>Verify deployment: <code>kubectl get all -n cert-manager</code></li>
<li>(optional) Verify dns01-recursive-nameserver settings were applied: <code>kubectl -n cert-manager describe deploy cert-manager | grep dns01</code></li>
</ul>
<h2 id="verify-installation">Verify Installation</h2>
<p>At this point cert-manager should be running and ready to issue self-signed certificates. We can test that.</p>
<ul>
<li>Test with this file named <code>cert-manager-verify.yaml</code>:
<ul>
<li>Apply: <code>kubectl apply -f cert-manager-verify.yaml</code></li>
<li>Verify: <code>kubectl describe cert -n cert-manager-test</code></li>
<li>Cleanup: <code>kubectl delete -f cert-manager-verify.yaml</code></li>
</ul>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Namespace</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager-test</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Issuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">test-selfsigned</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager-test</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">selfSigned</span><span class="p">:</span><span class="w"> </span>{}<span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nn">---</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">selfsigned-cert</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager-test</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">dnsNames</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">secretName</span><span class="p">:</span><span class="w"> </span><span class="l">selfsigned-cert-tls</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">issuerRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">test-selfsigned</span><span class="w">
</span></span></span></code></pre></div></li>
</ul>
<h1 id="getting-certificates-from-lets-encrypt-using-cloudflare-dns">Getting Certificates From Let&rsquo;s Encrypt (using Cloudflare DNS)</h1>
<p>Now we are ready to hook up Let&rsquo;s Encrypt so we can get certificates that are signed by a trusted authority. It&rsquo;s always a good idea to start with the staging issuer when testing Let&rsquo;s Encrypt so you don&rsquo;t run into rate limits with their production infrastructure.</p>
<p>I&rsquo;m using Cloudflare for my DNS nameservers so these steps will be based on that setup.</p>
<h2 id="getting-a-cloudflare-api-token">Getting A Cloudflare API Token</h2>
<ul>
<li>Create a Kubernetes secret resource with your Cloudflare API token. This allows cert-manager to add custom _acme-challenge records for domain validation. This will be the same API token you use for both Staging and Production certificates, so you only need to create one of these.
<ul>
<li>In Cloudflare, you can generate a new API token by navigating to your user account &gt; My Profile &gt; API Tokens &gt; Create Token. Make sure token permissions include <code>All zones - Zone Settings:Read, Zone:Read, DNS:Edit</code> or you can limit to a specific zone if you have multiple and want to use different API Tokens for different zones.</li>
</ul>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-cloudflare-api-token-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">type</span><span class="p">:</span><span class="w"> </span><span class="l">Opaque</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">stringData</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">api-token</span><span class="p">:</span><span class="w"> </span><span class="l">&lt;api-token-goes-here&gt;</span><span class="w">
</span></span></span></code></pre></div></li>
<li>Apply the secret manifest: <code>kubectl apply -f letsencrypt-cloudflare-api-token-secret.yaml</code></li>
</ul>
<h2 id="deploying-a-cert-manager-issuer---staging">Deploying A cert-manager Issuer - Staging</h2>
<p>cert-manager has two types of issuers: Issuer and ClusterIssuer. Issuer is used for more fine-grained control, it can be placed within a specific namespace, etc. ClusterIssuer, as the name implies, can be accessed across the whole Kubernetes cluster. Since I&rsquo;m not getting too complicated, and also want to be able to easily utilize cert-manager from multiple namespaces, I&rsquo;m using ClusterIssuer. If you wanted to use Issuer, just pick a namespace and the steps are almost identical to this.</p>
<p>It&rsquo;s strongly recommended to test with Let&rsquo;s Encrypt&rsquo;s staging server to avoid any rate limiting. You are far less likely to run into rate limits during testing while using the staging issuer, and once you get this working it&rsquo;s simply a matter of updating the ACME server URL to the production issuer and changing the name on the Issuer/ClusterIssuer (or you can run boht at the same time).</p>
<p><a href="https://letsencrypt.org/docs/staging-environment/">https://letsencrypt.org/docs/staging-environment/</a></p>
<p>You can use any valid email address. When you request a new cert, the email address is registered with that particular request, and that&rsquo;s where they will send renewal/expiry notices.</p>
<ul>
<li>Create a manifest file for the staging issuer <code>letsencrypt-staging-clusterissuer.yaml</code>. Update your email address:
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-staging</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">acme</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># The ACME server URL</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">server</span><span class="p">:</span><span class="w"> </span><span class="l">https://acme-staging-v02.api.letsencrypt.org/directory</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Email address used for ACME registration</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">email</span><span class="p">:</span><span class="w"> </span><span class="l">mail@example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Name of a secret used to store the ACME account private key</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">privateKeySecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-staging-issuer-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Enable the DNS-01 challenge provider</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">solvers</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">dns01</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">cloudflare</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">apiTokenSecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-cloudflare-api-token-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l">api-token</span><span class="w">
</span></span></span></code></pre></div></li>
<li>Apply the staging issuer: <code>kubectl apply -f letsencrypt-staging-clusterissuer.yaml</code></li>
<li>Verify your ClusterIssuer exists (or Issuer if that&rsquo;s what you&rsquo;re using): <code>kubectl get clusterissuer</code></li>
</ul>
<h2 id="request-a-real-staging-certificate-from-lets-encrypt">Request A Real (Staging) Certificate From Let&rsquo;s Encrypt</h2>
<p>Now we need to deploy a Certificate resource (again) to test our Let&rsquo;s Encrypt staging ClusterIssuer. This is similar to the verify manifest like before, but only needs to include the Certificate resource. However, we also need to update a couple things, notably adding the field Certificate.spec.issuerRef.kind and setting its value to ClusterIssuer (see <a href="https://cert-manager.io/docs/usage/certificate/">https://cert-manager.io/docs/usage/certificate/</a>)</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-staging-certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">default</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">dnsNames</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">justkidding.example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">secretName</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-staging-cert-tls</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">issuerRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-staging</span><span class="w">
</span></span></span></code></pre></div><ul>
<li>Apply the Certificate manifest: <code>kubectl apply -f letsencrypt-staging-certificate.yaml</code></li>
<li>Check the Certificate is ready: <code>kubectl get certificate</code> - this will show Ready=False until it&rsquo;s fully issued</li>
<li>Be patient. This can sometimes be quick, but sometimes can take a while. My most recent attempt took 38 minutes (see Troubleshooting section below to dive into what&rsquo;s happening during the process).</li>
</ul>
<p>Once you get a certificate issued using the staging issuer, you are ready to move to production!</p>
<h2 id="deploying-a-cert-manager-issuer---production">Deploying A cert-manager Issuer - Production</h2>
<p>Follow the same steps as in Staging, but using the production ACME URL and probably not using the name &ldquo;staging&rdquo;.</p>
<ul>
<li>Create a manifest file for the production issuer <code>letsencrypt-production-clusterissuer.yaml</code>. Update your email address:
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-production</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">acme</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># The ACME server URL</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">server</span><span class="p">:</span><span class="w"> </span><span class="l">https://acme-v02.api.letsencrypt.org/directory</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Email address used for ACME registration</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">email</span><span class="p">:</span><span class="w"> </span><span class="l">mail@example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Name of a secret used to store the ACME account private key</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">privateKeySecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-production-issuer-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="c"># Enable the DNS-01 challenge provider</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">solvers</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="nt">dns01</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">        </span><span class="nt">cloudflare</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">          </span><span class="nt">apiTokenSecretRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-cloudflare-api-token-secret</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">            </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l">api-token</span><span class="w">
</span></span></span></code></pre></div></li>
<li>Apply the staging issuer: <code>kubectl apply -f letsencrypt-production-clusterissuer.yaml</code></li>
<li>Verify your ClusterIssuer exists (or Issuer if that&rsquo;s what you&rsquo;re using): <code>kubectl get clusterissuer</code></li>
</ul>
<h2 id="request-a-real-production-certificate-from-lets-encrypt">Request A Real (Production) Certificate From Let&rsquo;s Encrypt</h2>
<p>This is exactly the same as for staging, except we make the request from the production ClusterIssuer (the last line in the yaml file says which ClusterIssuer to use).</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">apiVersion</span><span class="p">:</span><span class="w"> </span><span class="l">cert-manager.io/v1</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">Certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">metadata</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-production-certificate</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l">default</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">spec</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">dnsNames</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span>- <span class="l">justkidding.example.com</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">secretName</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-production-cert-tls</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">issuerRef</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">kind</span><span class="p">:</span><span class="w"> </span><span class="l">ClusterIssuer</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l">letsencrypt-production</span><span class="w">
</span></span></span></code></pre></div><ul>
<li>Apply the Certificate manifest: <code>kubectl apply -f letsencrypt-production-certificate.yaml</code></li>
<li>Check the Certificate is ready: <code>kubectl get certificate</code> - this will show Ready=False until it&rsquo;s fully issued</li>
<li>Be patient. This can sometimes be quick, but sometimes can take a while depending on a lot of factors. See Troubleshooting below for some tips.</li>
</ul>
<h1 id="troubleshooting-certificate-requests">Troubleshooting Certificate Requests</h1>
<ul>
<li>Definitive guide: <a href="https://cert-manager.io/docs/troubleshooting/">https://cert-manager.io/docs/troubleshooting/</a>
<ul>
<li>Also for Let&rsquo;s Encrypt: <a href="https://cert-manager.io/docs/troubleshooting/acme/">https://cert-manager.io/docs/troubleshooting/acme/</a></li>
</ul>
</li>
<li><code>kubectl get certificaterequests</code></li>
<li><code>kubectl describe certificaterequests</code></li>
<li><code>kubectl get order</code></li>
<li><code>kubectl describe order</code></li>
<li><code>kubectl get challenge</code></li>
<li><code>kubectl describe challenge</code>
<ul>
<li>This level will tell you if it&rsquo;s stuck waiting for DNS challenge (basically it&rsquo;s waiting for the _acme-challenge record to be added and validated from the cert-manager service. This is where sometimes you can get timeouts if your network doesn&rsquo;t allow cert-manager to query public DNS servers to check).</li>
<li>Troubleshooting steps I&rsquo;ve had here were basically verifying that the DNS record exists in Cloudflare while it&rsquo;s waiting. If it is, wait a while to see if it eventually solves the challenge. If not, you might need to dive deeper into dns01-recursive-nameserver settings (see above) or otherwise make sure your internal DNS resolver is able to query the new record.</li>
<li>In the output, look for Challenge.Spec.Key which is the value you should see in the _acme-challenge TXT record</li>
</ul>
</li>
<li>You can also check the logs on the cert-manager container
<ul>
<li>Find the pod name: <code>kubectl get po -n cert-manager</code></li>
<li><code>kubectl logs cert-manager-556766675f-pt123 -n cert-manager</code></li>
</ul>
</li>
<li>See cert-manager issue for more discussion: <a href="https://github.com/cert-manager/cert-manager/issues/5917">https://github.com/cert-manager/cert-manager/issues/5917</a></li>
</ul>
<h1 id="what-about-ingress">What About Ingress?</h1>
<p>I&rsquo;ll revisit this topic after we get to Ingress Controllers (using Traefik) and how to get certificates from Let&rsquo;s Encrypt. It&rsquo;s significantly easier than this, and since we already have this production ClusterIssuer in place, you basically just add a line in your Ingress resource to use this ClusterIssuer to attach a certificate and cert-manager does the rest!</p>
]]></content:encoded>
    </item>
    
  </channel>
</rss>
