Legacy-Sandbox-Snapshot-Vorlage

​

Terminologie

• Commit: Eine Commit-Operation speichert den aktuellen Zustand einer Sandbox als Vorlage, wodurch eine neue Vorlage vom Typ Snapshot-Vorlage entsteht.
• Ursprungs-Sandbox: Die Sandbox-Instanz, für die der Commit ausgeführt wird.
• Snapshot-Vorlage: Die nach einer Commit-Operation erzeugte Vorlage.

​

Funktionsbeschreibung

​

Commit einer laufenden Sandbox

• Die Ursprungs-Sandbox wird während des Commits kurzzeitig angehalten;
• Die Sandbox-Instanz ist während der Unterbrechung nicht verfügbar;
• Die Dauer der Unterbrechung liegt nahe an der Zeit, die für eine einzelne Pause-Operation erforderlich ist.

• Der vorhandene Pause-Datensatz wird auf einen neuen Pause-Datensatz aktualisiert, basierend auf dem aktuellen Sandbox-Zustand;
• Die Ursprungs-Sandbox läuft weiter;
• Ein neuer Vorlagendatensatz wird erzeugt.

​

Commit einer pausierten Sandbox

• Der Commit-Prozess löst keinen Start der Ursprungs-Sandbox aus;
• Die Ursprungs-Sandbox bleibt im pausierten Zustand.

• Der vorhandene Pause-Datensatz wird nicht gelöscht;
• Ein neuer Vorlagendatensatz wird erzeugt.

​

Parameterbeschreibung

​

Rückgabewert

​

Codebeispiele

from novita_sandbox.core import Sandbox

# Commit an existing sandbox by ID to create a template snapshot
# sandbox_id: str - Required. The ID of the sandbox to commit
# alias: Optional[str] - Optional alias name for the created template
# Note: Default timeout is 10 minutes for commit operation
template = Sandbox.commit(
    sandbox_id="existing-sandbox-id",
    alias="my-template-alias"
)
print(f"Template ID: {template.template_id}")
print(f"Build ID: {template.build_id}")

import { Sandbox } from '@novita-sandbox/core'

// Commit an existing sandbox by ID to create a template snapshot
// sandboxId: string - Required. The ID of the sandbox to commit
// opts?: { alias?: string } - Optional commit options
const template = await Sandbox.commit('existing-sandbox-id', {
  alias: 'my-template-alias'
})
console.log(`Template ID: ${template.templateId}`)
console.log(`Build ID: ${template.buildId}`)

# Basic commit - creates a template snapshot from a sandbox
novita-sandbox-cli sandbox commit <sandboxID>

# Commit with alias - assign a friendly name to the template
novita-sandbox-cli sandbox commit <sandboxID> --alias my-template-alias