Nesta página, descrevemos como restaurar o Cassandra em uma única região.
Em uma implantação de região única, a Apigee híbrida é implantada em um único data center ou região. Se
você tiver várias organizações da Apigee na implantação, o processo de restauração vai restaurar dados para todas as organizações.
Em uma configuração de várias organizações, não é possível restaurar uma organização específica.
Como restaurar uma região de um backup
Atualize os detalhes da restauração do Cassandra no arquivo overrides.yaml:
Namespace para restauração. Use o namespace como no cluster original.
cassandra:hostNetwork
hostNetwork é obrigatório e precisa ser sempre definido como false.
restore:enabled
A restauração é desativada por padrão. É preciso definir essa
propriedade como true.
restore:serviceAccountPath
SA_JSON_FILE_PATH
O caminho no sistema de arquivos para a conta de serviço que você criou
para o backup.
restore:dbStorageBucket
CLOUD_STORAGE_BUCKET_NAME
O nome de um bucket do Google Cloud Storage que armazena arquivos de backup para serem usados na restauração de dados.
restore:cloudProvider
GCP
A propriedade cloudProvider: "GCP" é obrigatória.
restore:snapshotTimestamp
TIMESTAMP
O carimbo de data/hora do snapshot de backup a ser restaurado. Para verificar quais carimbos de data/hora podem ser usados, acesse dbStorageBucket e observe os arquivos presentes no bucket. Cada nome de arquivo contém um valor de carimbo de data/hora. Exemplo:
backup_20210203213003_apigee-cassandra-default-0.tgz
Onde 20210203213003 é o valor snapshotTimestamp que você
usaria se quisesse restaurar os backups criados nesse momento.
backup:enabled
Defina essa propriedade como false caso ela tenha sido configurada anteriormente como true.
Verifique se não há pods restantes no namespace da Apigee:
kubectl get pods -n APIGEE_NAMESPACE
Se você estiver usando o backup CSI, verifique se os volumesnapshots que quer usar no processo de restauração
é exibido. Para isso, execute o seguinte comando:
kubectl get volumesnapshot -n APIGEE_NAMESPACE
Instale todos os componentes híbridos, um por um, conforme descrito na
Etapa 10: instalar a Apigee híbrida usando o Helm . O pod apigee-cassandra-restore será criado quando você executar o comando para instalar o datastore, mas ele só entrará no estado running depois que você instalar o componente apigee-org.
Verifique o progresso do job de restauração e confirme se apigeeds e todos os outros pods estão ativos:
Verificar apigeeds:
kubectl get apigeeds -n APIGEE_NAMESPACE
Verifique todos os outros pods:
kubectl get pods -n APIGEE_NAMESPACE
Após a conclusão bem-sucedida da restauração e da confirmação de que os componentes do ambiente de execução estão íntegros,
recomendamos que você configure um backup no cluster:
Remova a configuração restore do arquivo overrides-restore.yaml.
Adicione a configuração backup ao arquivo overrides-restore.yaml.
Aplique a configuração backup com o seguinte comando:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-28 UTC."],[[["\u003cp\u003eThis guide explains how to restore Cassandra data in an Apigee hybrid single-region deployment, which impacts all organizations within that deployment.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, determine if you need to preserve the existing setup for troubleshooting, and if so, delete all \u003ccode\u003eorg\u003c/code\u003e and \u003ccode\u003eenv\u003c/code\u003e components except the Apigee controller, then restore in a new cluster.\u003c/p\u003e\n"],["\u003cp\u003eRestoration is initiated by setting \u003ccode\u003erestore: enabled\u003c/code\u003e to \u003ccode\u003etrue\u003c/code\u003e in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e file, along with providing details like the service account path, storage bucket, cloud provider, and the snapshot timestamp.\u003c/p\u003e\n"],["\u003cp\u003eYou must ensure \u003ccode\u003ebackup: enabled\u003c/code\u003e is set to \u003ccode\u003efalse\u003c/code\u003e in the \u003ccode\u003eoverrides.yaml\u003c/code\u003e during the restore process to avoid conflicts.\u003c/p\u003e\n"],["\u003cp\u003eAfter the restore process completes, you should remove the \u003ccode\u003erestore\u003c/code\u003e configuration and add the \u003ccode\u003ebackup\u003c/code\u003e configuration to the \u003ccode\u003eoverrides-restore.yaml\u003c/code\u003e to re-enable backups.\u003c/p\u003e\n"]]],[],null,["# Restoring in a single region\n\n| You are currently viewing version 1.14 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nThis page describes how to restore Cassandra in a single region.\n\nIn a single region deployment, Apigee hybrid is deployed in a single data center or a region. If you\nhave multiple Apigee organizations in your deployment, the restore process restores data for all the organizations.\nIn a multi-organization setup, you cannot restore a specific organization.\n| **Note** : Before you begin restoring a single region, consider whether the following prerequisite steps are applicable:\n|\n| - If you want to preserve an existing setup for troubleshooting and root cause analysis (RCA), you should delete all the `org` and `env` components from the Kubernetes cluster *except* the Apigee controller, and then retain the cluster. The cluster will contain the existing Apigee datastore (Cassandra) which you can use for troubleshooting. Create a new Kubernetes cluster and then restore Cassandra in the new cluster.\n| - If your hybrid installation was set up with multiple organizations, get the overrides files for each organization before proceeding with restore in a single region. You can add the restore configuration as described in [Step 3](#step3) to any **one** of the overrides files. Do not add the restore configuration to any other overrides file.\n\nRestoring a region from a backup\n--------------------------------\n\n1. Update the Cassandra restore details in the `overrides.yaml` file:\n\n ```actionscript-3\n namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.\n cassandra:\n hostNetwork: false\n ...\n restore:\n enabled: true\n serviceAccountPath: \"\u003cvar translate=\"no\"\u003eSA_JSON_FILE_PATH\u003c/var\u003e\"\n dbStorageBucket: \"\u003cvar translate=\"no\"\u003eCLOUD_STORAGE_BUCKET_NAME\u003c/var\u003e\"\n cloudProvider: \"GCP\" # required verbatim \"GCP\" (all caps)\n snapshotTimestamp: \"\u003cvar translate=\"no\"\u003eTIMESTAMP\u003c/var\u003e\"\n ...\n backup:\n enabled: false\n ...\n ```\n\n\n Where:\n\n | **Note:** In case you are using **CSI backup** , please follow the **example restore config** in the [CSI backup and restore](/apigee/docs/hybrid/v1.14/cassandra-csi-backup-restore#example-restore-config) documentation.\n2. In case you do not have a clean cluster to start out with, follow the\n [Decommission a hybrid region for helm](/apigee/docs/hybrid/v1.14/decommission-region#helm)\n documentation to bring your existing Hybrid installation into a clean state\n (you can leave the **Cert Manager** installed). This would bring you to an equal state\n as if you would have followed [Helm runtime setup manual](/apigee/docs/hybrid/v1.14/install-create-cluster)\n until the beginning of Step 11.\n\n3. Verify there are no pods remaining in the Apigee namespace:\n\n ```\n kubectl get pods -n APIGEE_NAMESPACE\n ```\n4. If you are using CSI backup, make sure that you can see\n the volumesnapshots you want to use for the restoration process by running:\n\n ```\n kubectl get volumesnapshot -n APIGEE_NAMESPACE\n \n ```\n5. Install all Hybrid components one by one as described in\n [Step 10: Install Apigee hybrid using Helm](/apigee/docs/hybrid/v1.14/install-helm-charts). Note that the `apigee-cassandra-restore` pod will get\n created once you run the command to install the `datastore`, but it will only\n go into `running` state after you install the `apigee-org` component.\n\nSee [Cassandra backup overview](/apigee/docs/hybrid/v1.14/cassandra-backup-overview) for more details on Cassandra backup and restore.\n\nVerify the restoration job progress and confirm that `apigeeds` and all the other pods are up:\n\n1. Check `apigeeds`: \n\n ```\n kubectl get apigeeds -n APIGEE_NAMESPACE\n ```\n2. Check all other pods: \n\n ```\n kubectl get pods -n APIGEE_NAMESPACE\n ```\n\nUpon successful completion of the restore and confirmation that the runtime components are healthy,\nwe recommend configuring a backup on the cluster:\n\n1. Remove the `restore` configuration from the `overrides-restore.yaml` file.\n2. Add the `backup` configuration to the `overrides-restore.yaml` file.\n3. Apply the `backup` configuration with the following command: \n\n ```\n helm upgrade datastore apigee-datastore/ \\\n --namespace APIGEE_NAMESPACE \\\n --atomic \\\n -f overrides-restore.yaml\n ```\n\n\u003cbr /\u003e\n\n| **Warning:** See [known issue 391861216](/apigee/docs/release/known-issues#391861216) affecting Apigee Hybrid and Cassandra after restore using a remote server or Cloud Storage."]]