Update Rasa X¶
To see which version of Rasa X you are currently running, hit the /version
endpoint:
curl https://example.com/api/version
To update to a newer version, choose the instructions that correspond to how you currently have Rasa X deployed:
One-Line Deploy Script¶
If you installed Rasa X using the One-Line Deploy Script, you can update your Rasa X installation to the latest version by re-running the command which you used for the installation.
curl -s get-rasa-x.rasa.com | sudo bashcopied!
Openshift or Kubernetes¶
If you want to upgrade the Rasa X chart to the latest version or change other values for an already installed Rasa X deployment:
Update the Rasa X / Rasa Enterprise and Rasa Open Source versions in your
values.yml
file.# rasax specific settings rasax: # Rasa X configuration you did in previous steps # ... tag: "0.28.6" # rasa: Settings common for all Rasa containers rasa: # Rasa Open Source configuration you did in previous steps # ... # tag refers to the Rasa image tag tag: "1.10.10-full"
Optional: If you want to modify any further parameters of an existing deployment, do so by setting the values in your
values.yml
.Get the release name which Helm used during the installation. If are unsure which release name was used, use the following command to find out the release name:
helm list --namespace <your namespace>
Upgrade the deployment
helm repo update helm upgrade \ --values values.yml \ --namespace <your namespace> \ --reuse-values \ <your release name> rasa-x/rasa-x
Docker-Compose Quick Install¶
Note
Be aware that while updating, the following files will be overwritten:
/etc/rasa/docker-compose.yml
/etc/rasa/.env
Make sure there are no changes in these files that you still need. This means that instead of directly modifying
docker-compose.yml
to e.g. add a custom channel volume or custom action server image, you should rather create a new file calleddocker-compose.override.yml
. Docker will automatically take that file into account and override any attributes indocker-compose.yml
with changes from the override file.
To install an update, fetch the
install.sh
for the latest version, and run it (if you are using Rasa Enterprise, make sure that your license is in your working directory for this step):curl -sSL -o install.sh https://storage.googleapis.com/rasa-x-releases/0.28.6/install.sh sudo bash ./install.sh
Make sure that the Docker environment file is updated with the newly installed versions by running:
cd /etc/rasa cat .env
After the installation is complete, pull the images:
cd /etc/rasa sudo docker-compose pull
Bring down your running Rasa X instance and start the updated version:
sudo docker-compose down sudo docker-compose up -d
Docker-Compose Manual Install¶
Note
Be aware that while updating, the following files will be overwritten:
/etc/rasa/docker-compose.yml
/etc/rasa/.env
Make sure there are no changes in these files that you still need. This means that instead of directly modifying
docker-compose.yml
to e.g. add a custom channel volume or custom action server image, you should rather create a new file calleddocker-compose.override.yml
. Docker will automatically take that file into account and override any attributes indocker-compose.yml
with changes from the override file.
Download the Rasa X files (
docker-compose.ce.yml
andrasa_x_commands.py
) for the latest version:Rasa X:
cd /etc/rasa wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/0.28.6/docker-compose.ce.yml wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.28.6/rasa_x_commands.py
Rasa Enterprise:
cd /etc/rasa wget -qO docker-compose.yml https://storage.googleapis.com/rasa-x-releases/0.28.6/docker-compose.ee.yml wget -qO rasa_x_commands.py https://storage.googleapis.com/rasa-x-releases/0.28.6/rasa_x_commands.py
Update your
.env
with the relevant values:RASA_X_VERSION=0.28.6 RASA_VERSION=1.10.10
Pull the new images:
# If you are using Rasa Enterprise, log in to the private Docker registry sudo docker login -u _json_key -p "$(cat /etc/rasa/gcr-auth.json)" https://gcr.io # Pull the new images sudo docker-compose pull
Bring down your running Rasa X instance and start the updated version:
sudo docker-compose down sudo docker-compose up -d
Local Mode¶
To upgrade to the latest version of Rasa X Local mode, use these commands:
pip install -U pip pip install -U rasa-x --extra-index-url https://pypi.rasa.com/simple
You can also specify a version to install, like so:
pip install -U pip pip install rasa-x==|version| --extra-index-url https://pypi.rasa.com/simple