Ask or search…
K
Links
Comment on page

Updates

Download customer package

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
Checkout to the latest stable release:
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]

Single VM deployment

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:
1) Checkout to the latest stable release you want to update:
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 file
bash install.sh
Recreate the containers:
docker-compose up -d

Orchestrated container deployment

Follow the steps below if you're using an Orchestrated container deployment in Kubernetes.

Update steps

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