Documentation for version v0.9.0 is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.
ark version >=
0.1.0, you can use the
ark bug command to open a Github issue by launching a browser window with some prepopulated values. Values included are OS, CPU architecture,
kubectl client and server versions (if available) and the
ark client version. This information isn't submitted to Github until you click the
Submit new issue button in the Github UI, so feel free to add, remove or update whatever information you like.
Some general commands for troubleshooting that may be helpful:
ark backup describe <backupName>- describe the details of a backup
ark backup logs <backupName>- fetch the logs for this specific backup. Useful for viewing failures and warnings, including resources that could not be backed up.
ark restore describe <restoreName>- describe the details of a restore
ark restore logs <restoreName>- fetch the logs for this specific restore. Useful for viewing failures and warnings, including resources that could not be restored.
kubectl logs deployment/ark -n heptio-ark- fetch the logs of the Ark server pod. This provides the output of the Ark server processes.
You can increase the verbosity of the Ark server by editing your Ark deployment to look like this:
kubectl edit deployment/ark -n heptio-ark ... containers: - name: ark image: gcr.io/heptio-images/ark:latest command: - /ark args: - server - --log-level # Add this line - debug # Add this line ...
custom resource not founderrors when starting up.
Ark's server will not start if the required Custom Resource Definitions are not found in Kubernetes. Apply
examples/common/00-prereqs.yaml file to create these defintions, then restart Ark.
ark backup logsreturns a
Downloading artifacts from object storage utilizes temporary, signed URLs. In the case of S3-compatible providers, such as Ceph, there may be differences between their implementation and the official S3 API that cause errors.
Here are some things to verify if you receive