Comment on page
Updates
Once a new release is available, you will need to download the latest customer package.
Clone the CARTO Self-Hosted github repo:
git clone https://github.com/CartoDB/carto-selfhosted.git
cd carto-selfhosted
git checkout tags/2023.10.25
You should Install the following packages on your machine:
yq
, jq
and gcloud
.Run the script passing the following arguments:
flag | description |
---|---|
-d | Directory containing the existing customer.env and key.json files. |
-s | Carto selfhosted installation mode. Possible values for mode are docker (Single VM deployment) and k8s (Orchestrated container deployment) |
./tools/carto-download-customer-package.sh -d /tmp/carto -s <mode>
Example output (using docker mode):
ℹ️ selfhosted mode: docker
✅ found: /tmp/carto/carto-values.yaml
✅ found: /tmp/carto/carto-secrets.yaml
✅ activating: service account credentials for: [[email protected]]
Copying gs://carto-tnt-onp-xxx-client-storage/customer-package/carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip...
/ [1 files][ 2.6 KiB/ 2.6 KiB]
Operation completed over 1 objects/2.6 KiB.
✅ downloading: carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
##############################################################
Current selfhosted version in [carto-values.yaml]: 2023.6.16
Latest selfhosted version downloaded: 2023-6-16
Downloaded file: carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
Downloaded from: gs://carto-tnt-onp-xxx-client-storage/customer-package/carto-selfhosted-docker-customer-package-xxx-2023-6-16.zip
##############################################################
✅ finished [0]
Follow the steps below if you're using a single VM deployment with Docker Compose.
To update your CARTO Self-hosted to the newest version you will need to run the following commands:
cd carto-selfhosted
git fetch
git checkout tags/2023.10.25
2) Save a backup copy of your current
customer.env
:mv customer.env customer.env.bak
3) Download the latest customer package (containing
customer.env
and key.json
files):./tools/carto-download-customer-package.sh -d . -s docker
4) Open side by side
customer.env
and customer.env.bak
and apply the customizations from customer.env.bak
in the new customer.env
Generate the
.env
filebash install.sh
Recreate the containers:
docker-compose up -d
Follow the steps below if you're using an Orchestrated container deployment in Kubernetes.
1) Update the helm chart:
helm repo update
2) Download the latest customer package
./tools/carto-download-customer-package.sh -d . -s k8s
3) Upgrade the CARTO application
helm upgrade \
carto \
carto/carto \
-f carto-values.yaml \
-f carto-secrets.yaml \
-f customizations.yaml
Last modified 8d ago