<!-- CANARY: REQ=REQ-DOCS-001; FEATURE="Docs"; ASPECT=Documentation; STATUS=TESTED; OWNER=docs; UPDATED=2026-01-15 --> <h2 id="geode-on-amazon-web-services-aws" class="position-relative d-flex align-items-center group"> <span>Geode on Amazon Web Services (AWS)</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="geode-on-amazon-web-services-aws" aria-haspopup="dialog" aria-label="Share link: Geode on Amazon Web Services (AWS)"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h2><div id="headingShareModal" class="heading-share-modal" role="dialog" aria-modal="true" aria-labelledby="headingShareTitle" hidden> <div class="hsm-dialog" role="document"> <div class="hsm-header"> <h2 id="headingShareTitle" class="h6 mb-0 fw-bold">Share this section</h2> <button type="button" class="hsm-close" aria-label="Close"> <i class="fa-solid fa-xmark"></i> </button> </div> <div class="hsm-body"> <label for="headingShareInput" class="form-label small text-muted mb-1 text-uppercase fw-bold" style="font-size: 0.7rem; letter-spacing: 0.5px;">Permalink</label> <div class="input-group mb-4 hsm-url-group"> <input id="headingShareInput" type="text" class="form-control font-monospace" readonly aria-readonly="true" style="font-size: 0.85rem;" /> <button class="btn btn-primary hsm-copy" type="button" aria-label="Copy" title="Copy"> <i class="fa-duotone fa-clipboard" aria-hidden="true"></i> </button> </div> <div class="small fw-bold mb-2 text-muted text-uppercase" style="font-size: 0.7rem; letter-spacing: 0.5px;">Share via</div> <div class="hsm-share-grid"> <a id="share-twitter" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> <i class="fa-brands fa-twitter me-2"></i>Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> <i class="fa-brands fa-linkedin me-2"></i>LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> <i class="fa-brands fa-facebook me-2"></i>Facebook </a> </div> </div> </div> </div> <style> .heading-share-modal { position: fixed; inset: 0; display: flex; justify-content: center; align-items: center; background: rgba(0, 0, 0, 0.6); z-index: 1050; padding: 1rem; backdrop-filter: blur(4px); -webkit-backdrop-filter: blur(4px); } .heading-share-modal[hidden] { display: none !important; } .hsm-dialog { max-width: 420px; width: 100%; background: var(--bs-body-bg, #fff); color: var(--bs-body-color, #212529); border: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); border-radius: 1rem; box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.25); overflow: hidden; animation: hsm-fade-in 0.2s ease-out; } @keyframes hsm-fade-in { from { opacity: 0; transform: scale(0.95); } to { opacity: 1; transform: scale(1); } } [data-bs-theme="dark"] .hsm-dialog { background: #1e293b; border-color: rgba(255,255,255,0.1); color: #f8f9fa; } .hsm-header { display: flex; justify-content: space-between; align-items: center; padding: 1rem 1.5rem; border-bottom: 1px solid var(--bs-border-color, rgba(0,0,0,0.1)); background: rgba(0,0,0,0.02); } [data-bs-theme="dark"] .hsm-header { background: rgba(255,255,255,0.02); border-color: rgba(255,255,255,0.1); } .hsm-close { background: transparent; border: none; color: inherit; opacity: 0.5; padding: 0.25rem 0.5rem; border-radius: 0.25rem; font-size: 1.2rem; line-height: 1; transition: opacity 0.2s; } .hsm-close:hover { opacity: 1; } .hsm-body { padding: 1.5rem; } .hsm-url-group { display: flex !important; align-items: stretch; } .hsm-url-group .form-control { flex: 1; min-width: 0; margin: 0; background: var(--bs-secondary-bg, #f8f9fa); border-color: var(--bs-border-color, #dee2e6); border-top-right-radius: 0; border-bottom-right-radius: 0; height: 42px; } .hsm-url-group .btn { flex: 0 0 auto; margin: 0; margin-left: -1px; border-top-left-radius: 0; border-bottom-left-radius: 0; height: 42px; display: flex; align-items: center; justify-content: center; padding: 0 1.25rem; z-index: 2; } [data-bs-theme="dark"] .hsm-url-group .form-control { background: #0f172a; border-color: #334155; color: #e2e8f0; } .hsm-share-grid { display: flex; flex-direction: column; gap: 0.5rem; } .hsm-share-grid .btn { display: flex; align-items: center; justify-content: center; font-size: 0.9rem; padding: 0.6rem; border-color: var(--bs-border-color); width: 100%; } [data-bs-theme="dark"] .hsm-share-grid .btn { color: #e2e8f0; border-color: #475569; } [data-bs-theme="dark"] .hsm-share-grid .btn:hover { background: #334155; border-color: #cbd5e1; } </style> <script> (function(){ const modal = document.getElementById('headingShareModal'); if(!modal) return; const input = modal.querySelector('#headingShareInput'); const copyBtn = modal.querySelector('.hsm-copy'); const twitter = modal.querySelector('#share-twitter'); const linkedin = modal.querySelector('#share-linkedin'); const facebook = modal.querySelector('#share-facebook'); const closeBtn = modal.querySelector('.hsm-close'); let lastFocus=null; let trapBound=false; function buildUrl(id){ return window.location.origin + window.location.pathname + '#' + id; } function isOpen(){ return !modal.hasAttribute('hidden'); } function hydrate(id){ const url=buildUrl(id); input.value=url; const enc=encodeURIComponent(url); const text=encodeURIComponent(document.title); if(twitter) twitter.href=`https://twitter.com/intent/tweet?url=${enc}&text=${text}`; if(linkedin) linkedin.href=`https://www.linkedin.com/sharing/share-offsite/?url=${enc}`; if(facebook) facebook.href=`https://www.facebook.com/sharer/sharer.php?u=${enc}`; } function openModal(id){ lastFocus=document.activeElement; hydrate(id); if(!isOpen()){ modal.removeAttribute('hidden'); } requestAnimationFrame(()=>{ input.focus(); }); trapFocus(); } function closeModal(){ if(!isOpen()) return; modal.setAttribute('hidden',''); if(lastFocus && typeof lastFocus.focus==='function') lastFocus.focus(); } function copyCurrent(){ try{ navigator.clipboard.writeText(input.value).then(()=>feedback(true),()=>fallback()); } catch(e){ fallback(); } } function fallback(){ input.select(); try{ document.execCommand('copy'); feedback(true);}catch(e){ feedback(false);} } function feedback(ok){ if(!copyBtn) return; const icon=copyBtn.querySelector('i'); if(!icon) return; const prev=copyBtn.getAttribute('data-prev')||icon.className; if(!copyBtn.getAttribute('data-prev')) copyBtn.setAttribute('data-prev',prev); icon.className= ok ? 'fa-duotone fa-clipboard-check':'fa-duotone fa-circle-exclamation'; setTimeout(()=>{ icon.className=prev; },1800); } function handleShareClick(e){ e.preventDefault(); const btn=e.currentTarget; const id=btn.getAttribute('data-share-target'); if(id) openModal(id); } function bindShareButtons(){ document.querySelectorAll('.h-share').forEach(btn=>{ if(!btn.dataset.hShareBound){ btn.addEventListener('click', handleShareClick); btn.dataset.hShareBound='1'; } }); } bindShareButtons(); if(document.readyState==='loading'){ document.addEventListener('DOMContentLoaded', bindShareButtons); } else { requestAnimationFrame(bindShareButtons); } document.addEventListener('click', function(e){ const shareBtn=e.target.closest && e.target.closest('.h-share'); if(shareBtn && !shareBtn.dataset.hShareBound){ handleShareClick.call(shareBtn, e); } }, true); document.addEventListener('click', e=>{ if(e.target===modal) closeModal(); if(e.target.closest && e.target.closest('.hsm-close')){ e.preventDefault(); closeModal(); } if(copyBtn && (e.target===copyBtn || (e.target.closest && e.target.closest('.hsm-copy')))) { e.preventDefault(); copyCurrent(); } }); document.addEventListener('keydown', e=>{ if(e.key==='Escape' && isOpen()) closeModal(); }); function trapFocus(){ if(trapBound) return; trapBound=true; modal.addEventListener('keydown', f=>{ if(f.key==='Tab' && isOpen()){ const focusable=[...modal.querySelectorAll('a[href],button,input,textarea,select,[tabindex]:not([tabindex="-1"])')].filter(el=>!el.hasAttribute('disabled')); if(!focusable.length) return; const first=focusable[0]; const last=focusable[focusable.length-1]; if(f.shiftKey && document.activeElement===first){ f.preventDefault(); last.focus(); } else if(!f.shiftKey && document.activeElement===last){ f.preventDefault(); first.focus(); } } }); } if(closeBtn) closeBtn.addEventListener('click', e=>{ e.preventDefault(); closeModal(); }); })(); </script><p>Amazon Web Services provides a comprehensive cloud platform for deploying Geode graph database. This guide covers AWS-specific deployment patterns, service integrations, and optimization strategies for running production Geode workloads on AWS infrastructure.</p> <h3 id="aws-deployment-options" class="position-relative d-flex align-items-center group"> <span>AWS Deployment Options</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="aws-deployment-options" aria-haspopup="dialog" aria-label="Share link: AWS Deployment Options"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h3> <h4 id="1-ec2-elastic-compute-cloud" class="position-relative d-flex align-items-center group"> <span>1. EC2 (Elastic Compute Cloud)</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="1-ec2-elastic-compute-cloud" aria-haspopup="dialog" aria-label="Share link: 1. EC2 (Elastic Compute Cloud)"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Direct deployment on EC2 instances provides maximum control and performance:</p> <p><strong>Instance Type Selection</strong>:</p> <p>For Geode, memory-optimized instances provide the best price/performance:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># R6g instances (ARM-based Graviton2, best price/performance)</span> </span></span><span class="line"><span class="cl">r6g.large <span class="c1"># 2 vCPU, 16 GiB RAM - Dev/test</span> </span></span><span class="line"><span class="cl">r6g.xlarge <span class="c1"># 4 vCPU, 32 GiB RAM - Small production</span> </span></span><span class="line"><span class="cl">r6g.2xlarge <span class="c1"># 8 vCPU, 64 GiB RAM - Medium production</span> </span></span><span class="line"><span class="cl">r6g.4xlarge <span class="c1"># 16 vCPU, 128 GiB RAM - Large production</span> </span></span><span class="line"><span class="cl">r6g.8xlarge <span class="c1"># 32 vCPU, 256 GiB RAM - Enterprise</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># R6i instances (Intel-based, for x86-64 compatibility)</span> </span></span><span class="line"><span class="cl">r6i.2xlarge <span class="c1"># 8 vCPU, 64 GiB RAM</span> </span></span><span class="line"><span class="cl">r6i.4xlarge <span class="c1"># 16 vCPU, 128 GiB RAM</span> </span></span><span class="line"><span class="cl">r6i.8xlarge <span class="c1"># 32 vCPU, 256 GiB RAM</span> </span></span></code></pre></div><p><strong>Launch EC2 Instance with AWS CLI</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create key pair</span> </span></span><span class="line"><span class="cl">aws ec2 create-key-pair <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --key-name geode-key <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --query <span class="s1">&#39;KeyMaterial&#39;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --output text &gt; geode-key.pem </span></span><span class="line"><span class="cl">chmod <span class="m">400</span> geode-key.pem </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create security group</span> </span></span><span class="line"><span class="cl">aws ec2 create-security-group <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --group-name geode-sg <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --description <span class="s2">&#34;Security group for Geode database&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --vpc-id vpc-0123456789abcdef0 </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Allow Geode client port (3141)</span> </span></span><span class="line"><span class="cl">aws ec2 authorize-security-group-ingress <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --group-id sg-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --protocol tcp <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --port <span class="m">3141</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --cidr 10.0.0.0/8 </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Allow Prometheus metrics (9090) - internal only</span> </span></span><span class="line"><span class="cl">aws ec2 authorize-security-group-ingress <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --group-id sg-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --protocol tcp <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --port <span class="m">9090</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --source-group sg-0123456789abcdef0 </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Launch instance</span> </span></span><span class="line"><span class="cl">aws ec2 run-instances <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --image-id ami-0c55b159cbfafe1f0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --count <span class="m">1</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-type r6g.2xlarge <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --key-name geode-key <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --security-group-ids sg-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --subnet-id subnet-0bb1c79de3EXAMPLE <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --block-device-mappings <span class="s1">&#39;[ </span></span></span><span class="line"><span class="cl"><span class="s1"> { </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;DeviceName&#34;: &#34;/dev/sda1&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Ebs&#34;: { </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;VolumeSize&#34;: 100, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;VolumeType&#34;: &#34;gp3&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Iops&#34;: 3000, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Throughput&#34;: 125, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;DeleteOnTermination&#34;: false, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Encrypted&#34;: true </span></span></span><span class="line"><span class="cl"><span class="s1"> } </span></span></span><span class="line"><span class="cl"><span class="s1"> } </span></span></span><span class="line"><span class="cl"><span class="s1"> ]&#39;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --tag-specifications <span class="s1">&#39;ResourceType=instance,Tags=[ </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Name,Value=geode-production}, </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Environment,Value=production}, </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Application,Value=geode} </span></span></span><span class="line"><span class="cl"><span class="s1"> ]&#39;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --user-data file://install-geode.sh </span></span></code></pre></div><p><strong>User Data Script</strong> (<code>install-geode.sh</code>):</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="cp">#!/bin/bash </span></span></span><span class="line"><span class="cl"><span class="cp"></span><span class="nb">set</span> -e </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Update system</span> </span></span><span class="line"><span class="cl">apt-get update </span></span><span class="line"><span class="cl">apt-get upgrade -y </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Install dependencies (assumes Zig 0.1.0+ available)</span> </span></span><span class="line"><span class="cl">apt-get install -y git make jq </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Build Geode from source</span> </span></span><span class="line"><span class="cl"><span class="nv">0.2.18</span><span class="o">=</span><span class="s2">&#34;v0.2.18&#34;</span> </span></span><span class="line"><span class="cl">git clone https://github.com/codeprosorg/geode </span></span><span class="line"><span class="cl"><span class="nb">cd</span> geode </span></span><span class="line"><span class="cl">git checkout <span class="si">${</span><span class="nv">0.2.18</span><span class="si">}</span> </span></span><span class="line"><span class="cl">make build </span></span><span class="line"><span class="cl">cp ./zig-out/bin/geode /usr/local/bin/geode </span></span><span class="line"><span class="cl">chmod +x /usr/local/bin/geode </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create geode user</span> </span></span><span class="line"><span class="cl">useradd -r -s /bin/false geode </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create data directory</span> </span></span><span class="line"><span class="cl">mkdir -p /var/lib/geode </span></span><span class="line"><span class="cl">chown geode:geode /var/lib/geode </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create systemd service</span> </span></span><span class="line"><span class="cl">cat &gt; /etc/systemd/system/geode.service <span class="s">&lt;&lt;&#39;EOF&#39; </span></span></span><span class="line"><span class="cl"><span class="s">[Unit] </span></span></span><span class="line"><span class="cl"><span class="s">Description=Geode Graph Database </span></span></span><span class="line"><span class="cl"><span class="s">After=network.target </span></span></span><span class="line"><span class="cl"><span class="s"> </span></span></span><span class="line"><span class="cl"><span class="s">[Service] </span></span></span><span class="line"><span class="cl"><span class="s">Type=simple </span></span></span><span class="line"><span class="cl"><span class="s">User=geode </span></span></span><span class="line"><span class="cl"><span class="s">Group=geode </span></span></span><span class="line"><span class="cl"><span class="s">ExecStart=/usr/local/bin/geode serve --listen 0.0.0.0:3141 --data /var/lib/geode </span></span></span><span class="line"><span class="cl"><span class="s">Restart=on-failure </span></span></span><span class="line"><span class="cl"><span class="s">RestartSec=10s </span></span></span><span class="line"><span class="cl"><span class="s">LimitNOFILE=65536 </span></span></span><span class="line"><span class="cl"><span class="s"> </span></span></span><span class="line"><span class="cl"><span class="s">[Install] </span></span></span><span class="line"><span class="cl"><span class="s">WantedBy=multi-user.target </span></span></span><span class="line"><span class="cl"><span class="s">EOF</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Start Geode</span> </span></span><span class="line"><span class="cl">systemctl daemon-reload </span></span><span class="line"><span class="cl">systemctl <span class="nb">enable</span> geode </span></span><span class="line"><span class="cl">systemctl start geode </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s2">&#34;Geode installation complete&#34;</span> </span></span></code></pre></div> <h4 id="2-ebs-elastic-block-store-configuration" class="position-relative d-flex align-items-center group"> <span>2. EBS (Elastic Block Store) Configuration</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="2-ebs-elastic-block-store-configuration" aria-haspopup="dialog" aria-label="Share link: 2. EBS (Elastic Block Store) Configuration"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Geode requires fast, persistent storage. EBS provides several volume types:</p> <p><strong>Volume Type Comparison</strong>:</p> <table> <thead> <tr> <th>Type</th> <th>Use Case</th> <th>IOPS</th> <th>Throughput</th> <th>Price</th> </tr> </thead> <tbody> <tr> <td>gp3</td> <td>General</td> <td>16,000</td> <td>1,000 MB/s</td> <td>$</td> </tr> <tr> <td>io2</td> <td>High perf</td> <td>64,000</td> <td>1,000 MB/s</td> <td>$$$</td> </tr> <tr> <td>io2 Block Express</td> <td>Enterprise</td> <td>256,000</td> <td>4,000 MB/s</td> <td>$$$$</td> </tr> </tbody> </table> <p><strong>Recommended Configuration</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create gp3 volume for production</span> </span></span><span class="line"><span class="cl">aws ec2 create-volume <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --availability-zone us-east-1a <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --size <span class="m">1000</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --volume-type gp3 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --iops <span class="m">16000</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --throughput <span class="m">1000</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --encrypted <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --kms-key-id arn:aws:kms:us-east-1:123456789012:key/... <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --tag-specifications <span class="s1">&#39;ResourceType=volume,Tags=[ </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Name,Value=geode-data}, </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Application,Value=geode} </span></span></span><span class="line"><span class="cl"><span class="s1"> ]&#39;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Attach to instance</span> </span></span><span class="line"><span class="cl">aws ec2 attach-volume <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --volume-id vol-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-id i-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --device /dev/sdf </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Format and mount (SSH into instance)</span> </span></span><span class="line"><span class="cl">mkfs.ext4 /dev/nvme1n1 </span></span><span class="line"><span class="cl">mkdir -p /var/lib/geode </span></span><span class="line"><span class="cl">mount /dev/nvme1n1 /var/lib/geode </span></span><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s1">&#39;/dev/nvme1n1 /var/lib/geode ext4 defaults,nofail 0 2&#39;</span> &gt;&gt; /etc/fstab </span></span></code></pre></div><p><strong>EBS Optimization</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Enable EBS optimization on instance</span> </span></span><span class="line"><span class="cl">aws ec2 modify-instance-attribute <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-id i-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --ebs-optimized </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create snapshot for backup</span> </span></span><span class="line"><span class="cl">aws ec2 create-snapshot <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --volume-id vol-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --description <span class="s2">&#34;Geode data backup </span><span class="k">$(</span>date +%Y-%m-%d<span class="k">)</span><span class="s2">&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --tag-specifications <span class="s1">&#39;ResourceType=snapshot,Tags=[ </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Name,Value=geode-backup}, </span></span></span><span class="line"><span class="cl"><span class="s1"> {Key=Date,Value=&#39;</span><span class="k">$(</span>date +%Y-%m-%d<span class="k">)</span><span class="s1">&#39;} </span></span></span><span class="line"><span class="cl"><span class="s1"> ]&#39;</span> </span></span></code></pre></div> <h4 id="3-elastic-load-balancer-elb" class="position-relative d-flex align-items-center group"> <span>3. Elastic Load Balancer (ELB)</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="3-elastic-load-balancer-elb" aria-haspopup="dialog" aria-label="Share link: 3. Elastic Load Balancer (ELB)"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Distribute traffic across multiple Geode instances:</p> <p><strong>Network Load Balancer</strong> (recommended for Geode):</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create NLB</span> </span></span><span class="line"><span class="cl">aws elbv2 create-load-balancer <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --name geode-nlb <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --type network <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --scheme internal <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --subnets subnet-0bb1c79de3EXAMPLE subnet-0bb1c79de3EXAMPLE2 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --tags <span class="nv">Key</span><span class="o">=</span>Name,Value<span class="o">=</span>geode-nlb </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create target group</span> </span></span><span class="line"><span class="cl">aws elbv2 create-target-group <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --name geode-targets <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --protocol TCP <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --port <span class="m">3141</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --vpc-id vpc-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --health-check-protocol TCP <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --health-check-port <span class="m">3141</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --health-check-interval-seconds <span class="m">10</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --healthy-threshold-count <span class="m">2</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --unhealthy-threshold-count <span class="m">2</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --tags <span class="nv">Key</span><span class="o">=</span>Name,Value<span class="o">=</span>geode-targets </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create listener</span> </span></span><span class="line"><span class="cl">aws elbv2 create-listener <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --load-balancer-arn arn:aws:elasticloadbalancing:us-east-1:... <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --protocol TCP <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --port <span class="m">3141</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --default-actions <span class="nv">Type</span><span class="o">=</span>forward,TargetGroupArn<span class="o">=</span>arn:aws:elasticloadbalancing:... </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Register instances</span> </span></span><span class="line"><span class="cl">aws elbv2 register-targets <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --target-group-arn arn:aws:elasticloadbalancing:... <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --targets <span class="nv">Id</span><span class="o">=</span>i-0123456789abcdef0 <span class="nv">Id</span><span class="o">=</span>i-0123456789abcdef1 <span class="nv">Id</span><span class="o">=</span>i-0123456789abcdef2 </span></span></code></pre></div> <h4 id="4-eks-elastic-kubernetes-service" class="position-relative d-flex align-items-center group"> <span>4. EKS (Elastic Kubernetes Service)</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="4-eks-elastic-kubernetes-service" aria-haspopup="dialog" aria-label="Share link: 4. EKS (Elastic Kubernetes Service)"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Deploy Geode on managed Kubernetes:</p> <p><strong>Create EKS Cluster with eksctl</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="c"># cluster-config.yaml</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">eksctl.io/v1alpha5</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">ClusterConfig</span><span class="w"> </span></span></span><span class="line"><span class="cl"><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">geode-cluster</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">region</span><span class="p">:</span><span class="w"> </span><span class="l">us-east-1</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;1.28&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">iam</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">withOIDC</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">managedNodeGroups</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">geode-nodes</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">instanceType</span><span class="p">:</span><span class="w"> </span><span class="l">r6g.2xlarge</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">desiredCapacity</span><span class="p">:</span><span class="w"> </span><span class="m">3</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">minSize</span><span class="p">:</span><span class="w"> </span><span class="m">3</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">maxSize</span><span class="p">:</span><span class="w"> </span><span class="m">10</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeSize</span><span class="p">:</span><span class="w"> </span><span class="m">100</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeType</span><span class="p">:</span><span class="w"> </span><span class="l">gp3</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeIOPS</span><span class="p">:</span><span class="w"> </span><span class="m">3000</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeThroughput</span><span class="p">:</span><span class="w"> </span><span class="m">125</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">privateNetworking</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">labels</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">role</span><span class="p">:</span><span class="w"> </span><span class="l">geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">workload</span><span class="p">:</span><span class="w"> </span><span class="l">database</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">tags</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">geode-node</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">Environment</span><span class="p">:</span><span class="w"> </span><span class="l">production</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">iam</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">attachPolicyARNs</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="l">arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">withAddonPolicies</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">ebs</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">cloudWatch</span><span class="p">:</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"></span><span class="nt">addons</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">vpc-cni</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">coredns</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">kube-proxy</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">aws-ebs-csi-driver</span><span class="w"> </span></span></span></code></pre></div><p><strong>Create cluster</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">eksctl create cluster -f cluster-config.yaml </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Install EBS CSI driver</span> </span></span><span class="line"><span class="cl">kubectl apply -k <span class="s2">&#34;github.com/kubernetes-sigs/aws-ebs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-1.25&#34;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create storage class</span> </span></span><span class="line"><span class="cl">kubectl apply -f - <span class="s">&lt;&lt;EOF </span></span></span><span class="line"><span class="cl"><span class="s">apiVersion: storage.k8s.io/v1 </span></span></span><span class="line"><span class="cl"><span class="s">kind: StorageClass </span></span></span><span class="line"><span class="cl"><span class="s">metadata: </span></span></span><span class="line"><span class="cl"><span class="s"> name: geode-ebs-gp3 </span></span></span><span class="line"><span class="cl"><span class="s">provisioner: ebs.csi.aws.com </span></span></span><span class="line"><span class="cl"><span class="s">parameters: </span></span></span><span class="line"><span class="cl"><span class="s"> type: gp3 </span></span></span><span class="line"><span class="cl"><span class="s"> iops: &#34;16000&#34; </span></span></span><span class="line"><span class="cl"><span class="s"> throughput: &#34;1000&#34; </span></span></span><span class="line"><span class="cl"><span class="s"> encrypted: &#34;true&#34; </span></span></span><span class="line"><span class="cl"><span class="s"> kmsKeyId: arn:aws:kms:us-east-1:123456789012:key/... </span></span></span><span class="line"><span class="cl"><span class="s">allowVolumeExpansion: true </span></span></span><span class="line"><span class="cl"><span class="s">volumeBindingMode: WaitForFirstConsumer </span></span></span><span class="line"><span class="cl"><span class="s">EOF</span> </span></span></code></pre></div><p><strong>Deploy Geode StatefulSet</strong>:</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">apps/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">StatefulSet</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">geode</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">geode</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">serviceName</span><span class="p">:</span><span class="w"> </span><span class="l">geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">replicas</span><span class="p">:</span><span class="w"> </span><span class="m">3</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">selector</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">matchLabels</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">template</span><span class="p">:</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">labels</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">app</span><span class="p">:</span><span class="w"> </span><span class="l">geode</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">nodeSelector</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">role</span><span class="p">:</span><span class="w"> </span><span class="l">geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">containers</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">geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="l">public.ecr.aws/geodedb/geode:0.2.18</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">ports</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">containerPort</span><span class="p">:</span><span class="w"> </span><span class="m">3141</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">client</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span>- <span class="nt">containerPort</span><span class="p">:</span><span class="w"> </span><span class="m">9090</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">metrics</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeMounts</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">data</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">mountPath</span><span class="p">:</span><span class="w"> </span><span class="l">/var/lib/geode</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">resources</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">requests</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;48Gi&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">cpu</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;6&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">limits</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">memory</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;56Gi&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">cpu</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;8&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">env</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">GEODE_LOG_LEVEL</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;info&#34;</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">AWS_REGION</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">value</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;us-east-1&#34;</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">volumeClaimTemplates</span><span class="p">:</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">data</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">accessModes</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">&#34;ReadWriteOnce&#34;</span><span class="p">]</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">storageClassName</span><span class="p">:</span><span class="w"> </span><span class="l">geode-ebs-gp3</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">resources</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">requests</span><span class="p">:</span><span class="w"> </span></span></span><span class="line"><span class="cl"><span class="w"> </span><span class="nt">storage</span><span class="p">:</span><span class="w"> </span><span class="l">1Ti</span><span class="w"> </span></span></span></code></pre></div> <h4 id="5-ecs-elastic-container-service" class="position-relative d-flex align-items-center group"> <span>5. ECS (Elastic Container Service)</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="5-ecs-elastic-container-service" aria-haspopup="dialog" aria-label="Share link: 5. ECS (Elastic Container Service)"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Run Geode on AWS Fargate or EC2-backed ECS:</p> <p><strong>ECS Task Definition</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;family&#34;</span><span class="p">:</span> <span class="s2">&#34;geode&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;networkMode&#34;</span><span class="p">:</span> <span class="s2">&#34;awsvpc&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;requiresCompatibilities&#34;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&#34;FARGATE&#34;</span><span class="p">],</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;cpu&#34;</span><span class="p">:</span> <span class="s2">&#34;8192&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;memory&#34;</span><span class="p">:</span> <span class="s2">&#34;61440&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;containerDefinitions&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;name&#34;</span><span class="p">:</span> <span class="s2">&#34;geode&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;image&#34;</span><span class="p">:</span> <span class="s2">&#34;public.ecr.aws/geodedb/geode:0.2.18&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;portMappings&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;containerPort&#34;</span><span class="p">:</span> <span class="mi">3141</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;protocol&#34;</span><span class="p">:</span> <span class="s2">&#34;tcp&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">},</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;containerPort&#34;</span><span class="p">:</span> <span class="mi">9090</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;protocol&#34;</span><span class="p">:</span> <span class="s2">&#34;tcp&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">],</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;mountPoints&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;sourceVolume&#34;</span><span class="p">:</span> <span class="s2">&#34;geode-data&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;containerPath&#34;</span><span class="p">:</span> <span class="s2">&#34;/var/lib/geode&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">],</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;logConfiguration&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;logDriver&#34;</span><span class="p">:</span> <span class="s2">&#34;awslogs&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;options&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;awslogs-group&#34;</span><span class="p">:</span> <span class="s2">&#34;/ecs/geode&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;awslogs-region&#34;</span><span class="p">:</span> <span class="s2">&#34;us-east-1&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;awslogs-stream-prefix&#34;</span><span class="p">:</span> <span class="s2">&#34;geode&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">],</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;volumes&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;name&#34;</span><span class="p">:</span> <span class="s2">&#34;geode-data&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;efsVolumeConfiguration&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;fileSystemId&#34;</span><span class="p">:</span> <span class="s2">&#34;fs-0123456789abcdef0&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;transitEncryption&#34;</span><span class="p">:</span> <span class="s2">&#34;ENABLED&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">]</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div><p><strong>Create ECS Service</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">aws ecs create-service <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --cluster geode-cluster <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --service-name geode-service <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --task-definition geode:1 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --desired-count <span class="m">3</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --launch-type FARGATE <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --network-configuration <span class="s2">&#34;awsvpcConfiguration={ </span></span></span><span class="line"><span class="cl"><span class="s2"> subnets=[subnet-0bb1c79de3EXAMPLE,subnet-0bb1c79de3EXAMPLE2], </span></span></span><span class="line"><span class="cl"><span class="s2"> securityGroups=[sg-0123456789abcdef0], </span></span></span><span class="line"><span class="cl"><span class="s2"> assignPublicIp=DISABLED </span></span></span><span class="line"><span class="cl"><span class="s2"> }&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --load-balancers <span class="s2">&#34;targetGroupArn=arn:aws:elasticloadbalancing:...,containerName=geode,containerPort=3141&#34;</span> </span></span></code></pre></div> <h3 id="aws-service-integration" class="position-relative d-flex align-items-center group"> <span>AWS Service Integration</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="aws-service-integration" aria-haspopup="dialog" aria-label="Share link: AWS Service Integration"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h3> <h4 id="s3-for-backups" class="position-relative d-flex align-items-center group"> <span>S3 for Backups</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="s3-for-backups" aria-haspopup="dialog" aria-label="Share link: S3 for Backups"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Automated backups to S3:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="cp">#!/bin/bash </span></span></span><span class="line"><span class="cl"><span class="cp"></span><span class="c1"># backup-to-s3.sh</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="nv">TIMESTAMP</span><span class="o">=</span><span class="k">$(</span>date +%Y%m%d-%H%M%S<span class="k">)</span> </span></span><span class="line"><span class="cl"><span class="nv">BACKUP_FILE</span><span class="o">=</span><span class="s2">&#34;/tmp/geode-backup-</span><span class="si">${</span><span class="nv">TIMESTAMP</span><span class="si">}</span><span class="s2">.tar.gz&#34;</span> </span></span><span class="line"><span class="cl"><span class="nv">S3_BUCKET</span><span class="o">=</span><span class="s2">&#34;s3://geode-backups&#34;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create backup</span> </span></span><span class="line"><span class="cl">/usr/local/bin/geode backup --output <span class="s2">&#34;</span><span class="nv">$BACKUP_FILE</span><span class="s2">&#34;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Upload to S3</span> </span></span><span class="line"><span class="cl">aws s3 cp <span class="s2">&#34;</span><span class="nv">$BACKUP_FILE</span><span class="s2">&#34;</span> <span class="s2">&#34;</span><span class="si">${</span><span class="nv">S3_BUCKET</span><span class="si">}</span><span class="s2">/</span><span class="k">$(</span>date +%Y/%m/%d<span class="k">)</span><span class="s2">/&#34;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Clean up local backup</span> </span></span><span class="line"><span class="cl">rm <span class="s2">&#34;</span><span class="nv">$BACKUP_FILE</span><span class="s2">&#34;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Lifecycle policy will archive old backups to Glacier</span> </span></span></code></pre></div><p><strong>S3 Lifecycle Policy</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-json" data-lang="json"><span class="line"><span class="cl"><span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Rules&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Id&#34;</span><span class="p">:</span> <span class="s2">&#34;Archive old Geode backups&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Status&#34;</span><span class="p">:</span> <span class="s2">&#34;Enabled&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Prefix&#34;</span><span class="p">:</span> <span class="s2">&#34;&#34;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Transitions&#34;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Days&#34;</span><span class="p">:</span> <span class="mi">30</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;StorageClass&#34;</span><span class="p">:</span> <span class="s2">&#34;STANDARD_IA&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">},</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Days&#34;</span><span class="p">:</span> <span class="mi">90</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;StorageClass&#34;</span><span class="p">:</span> <span class="s2">&#34;GLACIER&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">},</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Days&#34;</span><span class="p">:</span> <span class="mi">365</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;StorageClass&#34;</span><span class="p">:</span> <span class="s2">&#34;DEEP_ARCHIVE&#34;</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">],</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Expiration&#34;</span><span class="p">:</span> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="nt">&#34;Days&#34;</span><span class="p">:</span> <span class="mi">2555</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">]</span> </span></span><span class="line"><span class="cl"><span class="p">}</span> </span></span></code></pre></div> <h4 id="cloudwatch-monitoring" class="position-relative d-flex align-items-center group"> <span>CloudWatch Monitoring</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="cloudwatch-monitoring" aria-haspopup="dialog" aria-label="Share link: CloudWatch Monitoring"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p><strong>CloudWatch Metrics from Geode</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="kn">import</span> <span class="nn">boto3</span> </span></span><span class="line"><span class="cl"><span class="kn">from</span> <span class="nn">geode_client</span> <span class="kn">import</span> <span class="n">Client</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="n">cloudwatch</span> <span class="o">=</span> <span class="n">boto3</span><span class="o">.</span><span class="n">client</span><span class="p">(</span><span class="s1">&#39;cloudwatch&#39;</span><span class="p">,</span> <span class="n">region_name</span><span class="o">=</span><span class="s1">&#39;us-east-1&#39;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">async</span> <span class="k">def</span> <span class="nf">publish_metrics</span><span class="p">():</span> </span></span><span class="line"><span class="cl"> <span class="n">client</span> <span class="o">=</span> <span class="n">Client</span><span class="p">(</span><span class="n">host</span><span class="o">=</span><span class="s2">&#34;geode.internal&#34;</span><span class="p">,</span> <span class="n">port</span><span class="o">=</span><span class="mi">3141</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="k">async</span> <span class="k">with</span> <span class="n">client</span><span class="o">.</span><span class="n">connection</span><span class="p">()</span> <span class="k">as</span> <span class="n">conn</span><span class="p">:</span> </span></span><span class="line"><span class="cl"> <span class="c1"># Query Geode metrics</span> </span></span><span class="line"><span class="cl"> <span class="n">result</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="k">await</span> <span class="n">conn</span><span class="o">.</span><span class="n">query</span><span class="p">(</span><span class="s2">&#34;&#34;&#34; </span></span></span><span class="line"><span class="cl"><span class="s2"> MATCH (n) RETURN count(n) AS total_nodes </span></span></span><span class="line"><span class="cl"><span class="s2"> &#34;&#34;&#34;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"> <span class="n">node_count</span> <span class="o">=</span> <span class="n">result</span><span class="o">.</span><span class="n">bindings</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s1">&#39;total_nodes&#39;</span><span class="p">]</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"> <span class="c1"># Publish to CloudWatch</span> </span></span><span class="line"><span class="cl"> <span class="n">cloudwatch</span><span class="o">.</span><span class="n">put_metric_data</span><span class="p">(</span> </span></span><span class="line"><span class="cl"> <span class="n">Namespace</span><span class="o">=</span><span class="s1">&#39;Geode/Production&#39;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="n">MetricData</span><span class="o">=</span><span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;MetricName&#39;</span><span class="p">:</span> <span class="s1">&#39;TotalNodes&#39;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Value&#39;</span><span class="p">:</span> <span class="n">node_count</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Unit&#39;</span><span class="p">:</span> <span class="s1">&#39;Count&#39;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Timestamp&#39;</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">utcnow</span><span class="p">(),</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Dimensions&#39;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span><span class="s1">&#39;Name&#39;</span><span class="p">:</span> <span class="s1">&#39;Environment&#39;</span><span class="p">,</span> <span class="s1">&#39;Value&#39;</span><span class="p">:</span> <span class="s1">&#39;production&#39;</span><span class="p">},</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span><span class="s1">&#39;Name&#39;</span><span class="p">:</span> <span class="s1">&#39;Cluster&#39;</span><span class="p">,</span> <span class="s1">&#39;Value&#39;</span><span class="p">:</span> <span class="s1">&#39;main&#39;</span><span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">},</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;MetricName&#39;</span><span class="p">:</span> <span class="s1">&#39;QueryLatency&#39;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Value&#39;</span><span class="p">:</span> <span class="n">result</span><span class="o">.</span><span class="n">execution_time_ms</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Unit&#39;</span><span class="p">:</span> <span class="s1">&#39;Milliseconds&#39;</span><span class="p">,</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Timestamp&#39;</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">utcnow</span><span class="p">(),</span> </span></span><span class="line"><span class="cl"> <span class="s1">&#39;Dimensions&#39;</span><span class="p">:</span> <span class="p">[</span> </span></span><span class="line"><span class="cl"> <span class="p">{</span><span class="s1">&#39;Name&#39;</span><span class="p">:</span> <span class="s1">&#39;QueryType&#39;</span><span class="p">,</span> <span class="s1">&#39;Value&#39;</span><span class="p">:</span> <span class="s1">&#39;COUNT&#39;</span><span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">}</span> </span></span><span class="line"><span class="cl"> <span class="p">]</span> </span></span><span class="line"><span class="cl"> <span class="p">)</span> </span></span></code></pre></div><p><strong>CloudWatch Alarms</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># High error rate alarm</span> </span></span><span class="line"><span class="cl">aws cloudwatch put-metric-alarm <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-name geode-high-error-rate <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-description <span class="s2">&#34;Geode error rate &gt; 1%&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --metric-name ErrorRate <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --namespace Geode/Production <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --statistic Average <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --period <span class="m">300</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --evaluation-periods <span class="m">2</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --threshold 0.01 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --comparison-operator GreaterThanThreshold <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-actions arn:aws:sns:us-east-1:123456789012:geode-alerts </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># High latency alarm</span> </span></span><span class="line"><span class="cl">aws cloudwatch put-metric-alarm <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-name geode-high-latency <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-description <span class="s2">&#34;Geode P99 latency &gt; 500ms&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --metric-name QueryLatencyP99 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --namespace Geode/Production <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --statistic Average <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --period <span class="m">300</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --evaluation-periods <span class="m">2</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --threshold <span class="m">500</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --comparison-operator GreaterThanThreshold <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --alarm-actions arn:aws:sns:us-east-1:123456789012:geode-alerts </span></span></code></pre></div> <h4 id="aws-secrets-manager" class="position-relative d-flex align-items-center group"> <span>AWS Secrets Manager</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="aws-secrets-manager" aria-haspopup="dialog" aria-label="Share link: AWS Secrets Manager"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Store Geode credentials securely:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create secret</span> </span></span><span class="line"><span class="cl">aws secretsmanager create-secret <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --name geode/production/credentials <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --description <span class="s2">&#34;Geode production credentials&#34;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --secret-string <span class="s1">&#39;{ </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;username&#34;:&#34;admin&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;password&#34;:&#34;secure-password-here&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;tls_cert&#34;:&#34;&lt;paste-pem-certificate-here&gt;&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;tls_key&#34;:&#34;&lt;paste-pem-private-key-here&gt;&#34; </span></span></span><span class="line"><span class="cl"><span class="s1"> }&#39;</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Retrieve in application</span> </span></span><span class="line"><span class="cl">aws secretsmanager get-secret-value <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --secret-id geode/production/credentials <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --query SecretString <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --output text <span class="p">|</span> jq -r .password </span></span></code></pre></div><p><strong>Use in Python</strong>:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="kn">import</span> <span class="nn">boto3</span> </span></span><span class="line"><span class="cl"><span class="kn">import</span> <span class="nn">json</span> </span></span><span class="line"><span class="cl"><span class="kn">from</span> <span class="nn">geode_client</span> <span class="kn">import</span> <span class="n">AuthClient</span><span class="p">,</span> <span class="n">Client</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">def</span> <span class="nf">get_geode_credentials</span><span class="p">():</span> </span></span><span class="line"><span class="cl"> <span class="n">client</span> <span class="o">=</span> <span class="n">boto3</span><span class="o">.</span><span class="n">client</span><span class="p">(</span><span class="s1">&#39;secretsmanager&#39;</span><span class="p">,</span> <span class="n">region_name</span><span class="o">=</span><span class="s1">&#39;us-east-1&#39;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="n">response</span> <span class="o">=</span> <span class="n">client</span><span class="o">.</span><span class="n">get_secret_value</span><span class="p">(</span><span class="n">SecretId</span><span class="o">=</span><span class="s1">&#39;geode/production/credentials&#39;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="k">return</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">response</span><span class="p">[</span><span class="s1">&#39;SecretString&#39;</span><span class="p">])</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="k">async</span> <span class="k">def</span> <span class="nf">connect_to_geode</span><span class="p">():</span> </span></span><span class="line"><span class="cl"> <span class="n">creds</span> <span class="o">=</span> <span class="n">get_geode_credentials</span><span class="p">()</span> </span></span><span class="line"><span class="cl"> <span class="n">client</span> <span class="o">=</span> <span class="n">Client</span><span class="p">(</span><span class="n">host</span><span class="o">=</span><span class="s2">&#34;geode.internal&#34;</span><span class="p">,</span> <span class="n">port</span><span class="o">=</span><span class="mi">3141</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="k">async</span> <span class="k">with</span> <span class="n">client</span><span class="o">.</span><span class="n">connection</span><span class="p">()</span> <span class="k">as</span> <span class="n">conn</span><span class="p">:</span> </span></span><span class="line"><span class="cl"> <span class="n">auth</span> <span class="o">=</span> <span class="n">AuthClient</span><span class="p">(</span><span class="n">conn</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="k">await</span> <span class="n">auth</span><span class="o">.</span><span class="n">login</span><span class="p">(</span><span class="n">creds</span><span class="p">[</span><span class="s1">&#39;username&#39;</span><span class="p">],</span> <span class="n">creds</span><span class="p">[</span><span class="s1">&#39;password&#39;</span><span class="p">])</span> </span></span><span class="line"><span class="cl"> <span class="n">result</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="k">await</span> <span class="n">conn</span><span class="o">.</span><span class="n">query</span><span class="p">(</span><span class="s2">&#34;MATCH (n) RETURN count(n) AS total&#34;</span><span class="p">)</span> </span></span><span class="line"><span class="cl"> <span class="k">return</span> <span class="n">result</span><span class="o">.</span><span class="n">rows</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">&#34;total&#34;</span><span class="p">]</span> <span class="k">if</span> <span class="n">result</span><span class="o">.</span><span class="n">rows</span> <span class="k">else</span> <span class="mi">0</span> </span></span></code></pre></div> <h4 id="route-53-dns" class="position-relative d-flex align-items-center group"> <span>Route 53 DNS</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="route-53-dns" aria-haspopup="dialog" aria-label="Share link: Route 53 DNS"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Create hosted zone</span> </span></span><span class="line"><span class="cl">aws route53 create-hosted-zone <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --name geodedb.internal <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --vpc <span class="nv">VPCRegion</span><span class="o">=</span>us-east-1,VPCId<span class="o">=</span>vpc-0123456789abcdef0 <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --caller-reference <span class="k">$(</span>date +%s<span class="k">)</span> </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Create A record for NLB</span> </span></span><span class="line"><span class="cl">aws route53 change-resource-record-sets <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --hosted-zone-id Z1234567890ABC <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --change-batch <span class="s1">&#39;{ </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Changes&#34;: [{ </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Action&#34;: &#34;CREATE&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;ResourceRecordSet&#34;: { </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Name&#34;: &#34;geode.geodedb.internal&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;Type&#34;: &#34;A&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;AliasTarget&#34;: { </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;HostedZoneId&#34;: &#34;Z215JYRZR1TBD5&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;DNSName&#34;: &#34;geode-nlb-1234567890.elb.us-east-1.amazonaws.com&#34;, </span></span></span><span class="line"><span class="cl"><span class="s1"> &#34;EvaluateTargetHealth&#34;: true </span></span></span><span class="line"><span class="cl"><span class="s1"> } </span></span></span><span class="line"><span class="cl"><span class="s1"> } </span></span></span><span class="line"><span class="cl"><span class="s1"> }] </span></span></span><span class="line"><span class="cl"><span class="s1"> }&#39;</span> </span></span></code></pre></div> <h3 id="cost-optimization" class="position-relative d-flex align-items-center group"> <span>Cost Optimization</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="cost-optimization" aria-haspopup="dialog" aria-label="Share link: Cost Optimization"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h3> <h4 id="reserved-instances" class="position-relative d-flex align-items-center group"> <span>Reserved Instances</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="reserved-instances" aria-haspopup="dialog" aria-label="Share link: Reserved Instances"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Save up to 72% with 3-year reservations:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># View available offerings</span> </span></span><span class="line"><span class="cl">aws ec2 describe-reserved-instances-offerings <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-type r6g.2xlarge <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --offering-class standard <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --product-description Linux/UNIX </span></span><span class="line"><span class="cl"> </span></span><span class="line"><span class="cl"><span class="c1"># Purchase 1-year RI</span> </span></span><span class="line"><span class="cl">aws ec2 purchase-reserved-instances-offering <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --reserved-instances-offering-id &lt;offering-id&gt; <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-count <span class="m">3</span> </span></span></code></pre></div> <h4 id="savings-plans" class="position-relative d-flex align-items-center group"> <span>Savings Plans</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="savings-plans" aria-haspopup="dialog" aria-label="Share link: Savings Plans"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>More flexible than RIs:</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Commit to $100/hour compute usage</span> </span></span><span class="line"><span class="cl">aws savingsplans create-savings-plan <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --savings-plan-offering-id &lt;offering-id&gt; <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --commitment <span class="m">100</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --upfront-payment-amount <span class="m">0</span> </span></span></code></pre></div> <h4 id="spot-instances" class="position-relative d-flex align-items-center group"> <span>Spot Instances</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="spot-instances" aria-haspopup="dialog" aria-label="Share link: Spot Instances"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h4><p>Use for non-critical workloads (up to 90% discount):</p> <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="c1"># Launch spot instance</span> </span></span><span class="line"><span class="cl">aws ec2 run-instances <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-type r6g.2xlarge <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --instance-market-options <span class="s1">&#39;{&#34;MarketType&#34;:&#34;spot&#34;,&#34;SpotOptions&#34;:{&#34;MaxPrice&#34;:&#34;0.10&#34;}}&#39;</span> <span class="se">\ </span></span></span><span class="line"><span class="cl"><span class="se"></span> --image-id ami-0c55b159cbfafe1f0 </span></span></code></pre></div> <h3 id="related-topics" class="position-relative d-flex align-items-center group"> <span>Related Topics</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="related-topics" aria-haspopup="dialog" aria-label="Share link: Related Topics"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h3><ul> <li><strong><a href="/tags/cloud/" >Cloud</a> </strong>: General cloud deployment</li> <li><strong><a href="/tags/gcp/" >GCP</a> </strong>: Google Cloud Platform</li> <li><strong><a href="/tags/azure/" >Azure</a> </strong>: Microsoft Azure</li> <li><strong><a href="/tags/containers/" >Containers</a> </strong>: Container technologies</li> <li><strong><a href="/tags/orchestration/" >Orchestration</a> </strong>: Kubernetes orchestration</li> <li><strong><a href="/tags/deployment/" >Deployment</a> </strong>: Deployment strategies</li> </ul> <h3 id="further-reading" class="position-relative d-flex align-items-center group"> <span>Further Reading</span> <button type="button" class="h-share btn btn-link p-0 text-decoration-none link-secondary opacity-50 hover-opacity-100 transition-all ms-1" data-share-target="further-reading" aria-haspopup="dialog" aria-label="Share link: Further Reading"> <i class="fa-sharp-duotone fa-solid fa-share-nodes" aria-hidden="true" style="font-size: 0.8em;"></i> <span class="visually-hidden">Share link</span> </button> </h3><ul> <li><strong>AWS Deployment Guide</strong>: <code>/docs/deployment/aws/</code></li> <li><strong>EKS Best Practices</strong>: <code>/docs/deployment/eks-best-practices/</code></li> <li><strong>AWS Cost Optimization</strong>: <code>/docs/operations/aws-cost-optimization/</code></li> <li><strong>CloudWatch Integration</strong>: <code>/docs/monitoring/cloudwatch/</code></li> <li><strong>AWS Security</strong>: <code>/docs/security/aws-security/</code></li> </ul>

Related Articles

No articles found with this tag yet.

Back to Home