Version Management & Compatibility

Managing database versions effectively is critical for maintaining stable, secure, and performant systems. Geode provides comprehensive version management capabilities including explicit version tracking, compatibility matrices, automated upgrade paths, and multi-version deployment support for enterprise environments. As an ISO/IEC 39075:2024 GQL-compliant graph database, Geode follows semantic versioning with clear compatibility guarantees, enabling predictable upgrade strategies and safe dependency management across complex deployment environments. <h3 id="version-numbering-scheme" class="position-relative d-flex align-items-center group"> Version Numbering Scheme <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="version-numbering-scheme" aria-haspopup="dialog" aria-label="Share link: Version Numbering Scheme"> Share link </button> </h3><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"> </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"> </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"> Twitter </a> <a id="share-linkedin" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> LinkedIn </a> <a id="share-facebook" class="btn btn-outline-secondary w-100" target="_blank" rel="noopener noreferrer"> 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>Geode uses semantic versioning (SemVer 2.0.0): <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD] Current Version: 0.2.18 Next Minor: 0.3.0 Next Major: 1.0.0 </code></pre></div>Version Components Explained: MAJOR Version (0.x.x → 1.x.x): <ul> <li>Breaking API changes</li> <li>Protocol incompatibilities</li> <li>Database format changes requiring migration</li> <li>Removal of deprecated features</li> <li>Example: 0.2.15 → 1.0.0</li> </ul> MINOR Version (0.2.x → 0.3.x): <ul> <li>New backward-compatible features</li> <li>New GQL functions or operators</li> <li>Performance improvements</li> <li>Enhanced client capabilities</li> <li>Example: 0.2.15 → 0.3.0</li> </ul> PATCH Version (0.2.14 → 0.2.15): <ul> <li>Bug fixes</li> <li>Security patches</li> <li>Documentation corrections</li> <li>Minor optimizations</li> <li>Example: 0.2.14 → 0.2.15</li> </ul> <h3 id="current-version-geode_version" class="position-relative d-flex align-items-center group"> Current Version: 0.2.18 <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="current-version-geode_version" aria-haspopup="dialog" aria-label="Share link: Current Version: GEODE_"> Share link </button> </h3>Server Version: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash">$ geode version Geode v0.2.18 Build: 20260329-<release-sha> Zig: 0.1.0 Protocol: QUIC v1 GQL: ISO/IEC 39075:2024 </code></pre></div>Client Library Versions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Go geodedb.com/geode v0.2.18 # Python geode-client==0.3.19 # Rust geode-client = "0.1.1-alpha.8" # Zig geode-client v0.1.0 </code></pre></div> <h3 id="version-compatibility-matrix" class="position-relative d-flex align-items-center group"> Version Compatibility Matrix <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="version-compatibility-matrix" aria-haspopup="dialog" aria-label="Share link: Version Compatibility Matrix"> Share link </button> </h3> <h4 id="server-client-compatibility" class="position-relative d-flex align-items-center group"> Server-Client Compatibility <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="server-client-compatibility" aria-haspopup="dialog" aria-label="Share link: Server-Client Compatibility"> Share link </button> </h4><table> <thead> <tr> <th>Server Version</th> <th>Go Client</th> <th>Python Client</th> <th>Rust Client</th> <th>Zig Client</th> <th>Protocol</th> </tr> </thead> <tbody> <tr> <td>0.2.x</td> <td>rolling</td> <td>0.3.19+</td> <td>0.1.1-alpha.8+</td> <td>0.1.0+</td> <td>QUIC v1</td> </tr> <tr> <td>0.1.28-0.1.39</td> <td>rolling</td> <td>0.3.19+</td> <td>0.1.1-alpha.8+</td> <td>0.1.0+</td> <td>QUIC v1</td> </tr> <tr> <td>0.1.3-0.1.27</td> <td>validate in staging</td> <td>0.3.x</td> <td>0.1.x</td> <td>0.1.x</td> <td>QUIC v1</td> </tr> </tbody> </table> Compatibility Rules: <ul> <li>Prefer Current Stable Line: Match the current stable server line with the latest published client for that language</li> <li>Patch Flexibility: Any patch version within the same minor version is compatible</li> <li>Major Boundaries: Crossing major versions requires explicit migration</li> <li>Forward Compatibility: Clients may connect to newer server patch versions</li> <li>Backward Compatibility: Servers support clients from the same minor version</li> </ul> <h4 id="protocol-version-compatibility" class="position-relative d-flex align-items-center group"> Protocol Version Compatibility <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="protocol-version-compatibility" aria-haspopup="dialog" aria-label="Share link: Protocol Version Compatibility"> Share link </button> </h4><table> <thead> <tr> <th>Version</th> <th>Protocol</th> <th>Transport Notes</th> <th>TLS</th> <th>Port</th> <th>Status</th> </tr> </thead> <tbody> <tr> <td>0.2.x</td> <td>QUIC v1</td> <td>Multiplexed streams</td> <td>TLS 1.3</td> <td>3141</td> <td>Current</td> </tr> <tr> <td>0.1.28-0.1.39</td> <td>QUIC v1</td> <td>March 2026 storage transition line</td> <td>TLS 1.3</td> <td>3141</td> <td>Upgrade planned</td> </tr> <tr> <td>0.1.3-0.1.27</td> <td>QUIC v1</td> <td>Early production-ready line</td> <td>TLS 1.3</td> <td>3141</td> <td>Legacy</td> </tr> </tbody> </table> Migration Path: Early <code>v0.1.x</code> stable line → March 2026 storage transition line → current <code>v0.2.x</code> stable line <h3 id="checking-versions" class="position-relative d-flex align-items-center group"> Checking Versions <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="checking-versions" aria-haspopup="dialog" aria-label="Share link: Checking Versions"> Share link </button> </h3>Server Version Check: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Version command geode version # Detailed version information geode version --verbose # JSON output for parsing geode version --json </code></pre></div>Client Version Check: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Go go list -m geodedb.com/geode # Python pip show geode-client # Rust cargo tree | grep geode-client # Zig zig build --version </code></pre></div>Runtime Version Negotiation: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Query server version from client SHOW VERSION; -- Returns: -- version: "0.2.18" -- build: "20240124-1a2b3c4" -- protocol: "QUIC v1" -- gql_version: "ISO/IEC 39075:2024" </code></pre></div> <h3 id="version-pinning" class="position-relative d-flex align-items-center group"> Version Pinning <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="version-pinning" aria-haspopup="dialog" aria-label="Share link: Version Pinning"> Share link </button> </h3>Package Manager Pinning: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Go - go.mod module myapp go 1.24 require ( geodedb.com/geode v0.2.18 // Exact version ) # Python - requirements.txt geode-client==0.3.19 # Exact version geode-client>=0.3.19,<0.4.0 # Version range # Rust - Cargo.toml [dependencies] geode-client = "=0.1.1-alpha.8" # Exact version # OR geode-client = "~0.1" # Same minor version # OR geode-client = "^0.1" # Compatible versions </code></pre></div>Container Version Pinning: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-dockerfile" data-lang="dockerfile"># Exact version FROM geodedb/geode:0.2.18 # Minor version (latest patch) FROM geodedb/geode:0.2 # Major version (latest minor) FROM geodedb/geode:0 # Latest (not recommended for production) FROM geodedb/geode:latest </code></pre></div>Configuration Version Lock: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"># config.yaml server: version_check: strict # Enforce exact version match min_client_version: "1.0.0" max_client_version: "1.0.99" </code></pre></div> <h3 id="upgrade-strategies" class="position-relative d-flex align-items-center group"> Upgrade Strategies <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="upgrade-strategies" aria-haspopup="dialog" aria-label="Share link: Upgrade Strategies"> Share link </button> </h3> <h4 id="rolling-upgrades-zero-downtime" class="position-relative d-flex align-items-center group"> Rolling Upgrades (Zero-Downtime) <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="rolling-upgrades-zero-downtime" aria-haspopup="dialog" aria-label="Share link: Rolling Upgrades (Zero-Downtime)"> Share link </button> </h4>For clustered deployments: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Upgrade standby nodes first ssh replica-1 "sudo apt-get install geode=0.2.18" ssh replica-2 "sudo apt-get install geode=0.2.18" # 2. Wait for replication sync geode cluster status # 3. Promote replica to primary geode cluster promote replica-1 # 4. Upgrade old primary ssh primary "sudo apt-get install geode=0.2.18" # 5. Rebalance cluster geode cluster rebalance </code></pre></div> <h4 id="blue-green-deployment" class="position-relative d-flex align-items-center group"> Blue-Green Deployment <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="blue-green-deployment" aria-haspopup="dialog" aria-label="Share link: Blue-Green Deployment"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Deploy new version to green environment docker-compose -f docker-compose.green.yml up -d # 2. Replicate data from blue to green geode replicate --from blue:3141 --to green:3141 # 3. Test green environment ./run-integration-tests.sh --host green:3141 # 4. Switch traffic to green kubectl patch service geode -p '{"spec":{"selector":{"version":"0.2.18"}}}' # 5. Decommission blue environment after validation docker-compose -f docker-compose.blue.yml down </code></pre></div> <h4 id="canary-deployment" class="position-relative d-flex align-items-center group"> Canary Deployment <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="canary-deployment" aria-haspopup="dialog" aria-label="Share link: Canary Deployment"> Share link </button> </h4><div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Route 10% of traffic to new version kubectl apply -f canary-10percent.yaml # 2. Monitor metrics and errors kubectl logs -l version=0.2.18 --tail=100 # 3. Gradually increase traffic: 25% → 50% → 100% kubectl apply -f canary-25percent.yaml kubectl apply -f canary-50percent.yaml kubectl apply -f canary-100percent.yaml </code></pre></div> <h3 id="multi-version-support" class="position-relative d-flex align-items-center group"> Multi-Version Support <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="multi-version-support" aria-haspopup="dialog" aria-label="Share link: Multi-Version Support"> Share link </button> </h3>Running Multiple Versions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Different versions on different ports /opt/geode-0.1.2/bin/geode serve --listen :8443 /opt/geode-0.2.18/bin/geode serve --listen :3141 # Docker containers docker run -p 8443:8443 geodedb/geode:0.1.2 docker run -p 3141:3141 geodedb/geode:0.2.18 </code></pre></div>Client Version Selection: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">// Go - include client version in HELLO db, err := sql.Open("geode", "localhost:3141?hello_ver=0.2.18") // Python - include client version in HELLO client = Client( host="localhost", port=3141, hello_ver="0.2.18" ) // Rust - include client version in HELLO let client = Client::new("localhost", 3141).hello_ver("0.2.18"); let mut conn = client.connect().await?; </code></pre></div> <h3 id="version-metadata" class="position-relative d-flex align-items-center group"> Version Metadata <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="version-metadata" aria-haspopup="dialog" aria-label="Share link: Version Metadata"> Share link </button> </h3>Query Runtime Version Information: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-gql" data-lang="gql">-- Server version details SHOW VERSION; -- Protocol capabilities SHOW PROTOCOL; -- Feature support matrix SHOW FEATURES; -- Client library version SHOW CLIENT_VERSION; </code></pre></div>Programmatic Version Access: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-go" data-lang="go">// Go version := conn.ServerVersion() fmt.Printf("Server: %s\n", version) fmt.Printf("Client: %s\n", geode.ClientVersion) // Python version = await client.get_server_version() print(f"Server: {version}") print(f"Client: {geode_client.__version__}") // Rust let version = client.server_version().await?; println!("Server: {}", version); println!("Client: {}", geode_client::VERSION); </code></pre></div> <h3 id="dependency-management" class="position-relative d-flex align-items-center group"> Dependency Management <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="dependency-management" aria-haspopup="dialog" aria-label="Share link: Dependency Management"> Share link </button> </h3>Transitive Dependencies: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Go - view dependency tree go mod graph | grep geode # Python - view dependencies pip show geode-client pipdeptree -p geode-client # Rust - dependency tree cargo tree -p geode-client </code></pre></div>Lock Files: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># Go - go.sum geodedb.com/geode v0.2.18 h1:abc123... geodedb.com/geode v0.2.18/go.mod h1:def456... # Python - poetry.lock or Pipfile.lock [[package]] name = "geode-client" version = "0.3.19" # Rust - Cargo.lock [[package]] name = "geode-client" version = "0.1.1-alpha.8" </code></pre></div> <h3 id="version-constraints-in-cicd" class="position-relative d-flex align-items-center group"> Version Constraints in CI/CD <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="version-constraints-in-cicd" aria-haspopup="dialog" aria-label="Share link: Version Constraints in CI/CD"> Share link </button> </h3>GitHub Actions: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">name: Test on: [push, pull_request] jobs: test: runs-on: ubuntu-latest services: geode: image: geodedb/geode:0.2.18 # Pin exact version ports: - 3141:3141 steps: - uses: actions/checkout@v3 - name: Install Client run: pip install geode-client==0.3.19 # Pin exact version - name: Run Tests run: pytest tests/ </code></pre></div>GitLab CI: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml">test: image: python:3.11 services: - name: geodedb/geode:0.2.18 alias: geode before_script: - pip install geode-client==0.3.19 script: - pytest tests/ </code></pre></div> <h3 id="breaking-change-migration" class="position-relative d-flex align-items-center group"> Breaking Change Migration <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="breaking-change-migration" aria-haspopup="dialog" aria-label="Share link: Breaking Change Migration"> Share link </button> </h3>When crossing major version boundaries: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"># 1. Review breaking changes geode changelog --breaking --since v0.2.18 # 2. Run migration checker geode migrate check --from 0.2.18 --to 1.0.0 # 3. Generate migration plan geode migrate plan --from 0.2.18 --to 1.0.0 --output plan.yaml # 4. Execute migration geode migrate execute --plan plan.yaml # 5. Validate migration geode migrate validate </code></pre></div> <h3 id="best-practices" class="position-relative d-flex align-items-center group"> Best Practices <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="best-practices" aria-haspopup="dialog" aria-label="Share link: Best Practices"> Share link </button> </h3><ol> <li>Pin Production Versions: Always use exact version constraints in production</li> <li>Test Upgrades: Validate new versions in staging before production</li> <li>Monitor Version Skew: Ensure client and server versions remain compatible</li> <li>Document Dependencies: Maintain clear documentation of version requirements</li> <li>Automate Checks: Use CI/CD to enforce version compatibility</li> <li>Plan Migrations: Schedule maintenance windows for major version upgrades</li> <li>Keep Current: Stay within supported version ranges (latest 2 minor versions)</li> </ol> <h3 id="troubleshooting-version-issues" class="position-relative d-flex align-items-center group"> Troubleshooting Version Issues <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="troubleshooting-version-issues" aria-haspopup="dialog" aria-label="Share link: Troubleshooting Version Issues"> Share link </button> </h3>Version Mismatch Errors: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Error: Client version 0.2.0 incompatible with server 0.2.18 Solution: Upgrade client to the current published line for your language </code></pre></div>Protocol Incompatibility: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Error: Protocol QUIC v1 required, but client uses TCP Solution: Upgrade to client library version 1.0.0+ </code></pre></div>Feature Not Available: <div class="highlight"><pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback">Error: CTE support not available in server version 0.2.13 Solution: Upgrade server to 0.2.18+ </code></pre></div> <h3 id="related-topics" class="position-relative d-flex align-items-center group"> Related Topics <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"> Share link </button> </h3><ul> <li>Release Notes and Versioning</li> <li>Version Changelog</li> <li>Migration Guides</li> <li>Compatibility Matrix</li> <li>Dependency Management</li> <li>Upgrade Procedures</li> <li>Standards Compliance</li> </ul> <h3 id="further-reading" class="position-relative d-flex align-items-center group"> Further Reading <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"> Share link </button> </h3><ul> <li>Semantic Versioning Specification</li> <li>Version Compatibility Testing</li> <li>Database Migration Strategies</li> <li>Dependency Management Best Practices</li> <li>CI/CD Version Pinning</li> <li>Multi-Version Deployment</li> <li>Upgrade Planning Guide</li> </ul>

Popular

Related Articles

Releases