|
25 | 25 | - [Creating and Managing Deployments](#creating-and-managing-deployments) |
26 | 26 | - [DNS](#dns) |
27 | 27 | - [SAS/CONNECT](#sasconnect) |
28 | | - - [Updating SAS Viya Manually](#updating-sas-viya-manually) |
29 | 28 | - [Troubleshooting](#troubleshooting) |
30 | 29 | - [Contributing](#contributing) |
31 | 30 | - [License](#license) |
|
34 | 33 |
|
35 | 34 | ## Overview |
36 | 35 |
|
| 36 | +- This project can only be used for patch updates that use the exact same manifest as the existing deployment. |
| 37 | +- Updating to a new SAS Viya platform version, cadence, or a new software offering is not supported using this project. |
| 38 | +- For more information about updating your software, see [The SAS Viya Deployment as a Code project does not perform updates](https://sas.service-now.com/csm?id=kb_article_view&sysparm_article=KB0041450). |
| 39 | + |
37 | 40 | This project contains Ansible code that creates a baseline cluster in an existing Kubernetes environment for use with the SAS Viya platform, generates the manifest for a SAS Viya platform software order, and then deploys that order into the specified Kubernetes environment. Here is a list of tasks that this tool can perform (also see [playbook overview](./playbooks/README.md) for info on the default tasks): |
38 | 41 |
|
39 | 42 | - Prepare Kubernetes cluster |
@@ -340,21 +343,10 @@ In the above example, the ingress controller's LoadBalancer endpoint is 52.52.52 |
340 | 343 | - An A record (such as `example.com`) that points to the 52.52.52.52 address |
341 | 344 | - A wildcard CNAME (`*.example.com`) that points to example.com |
342 | 345 |
|
343 | | - |
344 | 346 | #### SAS/CONNECT |
345 | 347 |
|
346 | 348 | When running the `viya` action with `V4_CFG_CONNECT_ENABLE_LOADBALANCER=true`, a separate loadbalancer service is created to allow external SAS/CONNECT clients to connect to the SAS Viya platform. You will need to register this LoadBalancer endpoint with your DNS provider such that the desired host name (for example, connect.example.com) points to the LoadBalancer endpoint. |
347 | 349 |
|
348 | | - |
349 | | -### Updating SAS Viya Manually |
350 | | - |
351 | | -Manual steps are required by the SAS software to update a SAS deployment in an existing cluster. As a result, viya4-deployment does not perform updates. The viya4-deployment tools can perform subsequent `viya,install` tasks if you are simply reapplying the same software order into the cluster. |
352 | | - |
353 | | -If you have an existing deployment that you performed with the viya4-deployment project, take the following steps in order to update the SAS Viya platform: |
354 | | - |
355 | | -- Follow the instructions in [Updating Software](https://documentation.sas.com/?cdcId=sasadmincdc&cdcVersion=default&docsetId=k8sag&docsetTarget=titlepage.htm) in the SAS Viya Platform Operations Guide. |
356 | | -- You are expected to modify the steps that are described in the SAS Viya Platform Operations Guide to accommodate the slightly different directory structure |
357 | | - |
358 | 350 | ### Troubleshooting |
359 | 351 |
|
360 | 352 | See the [Troubleshooting](./docs/Troubleshooting.md) page. |
|
0 commit comments