Updating the no. of stacks of application component

Currently, we are only supporting addition of new stacks. We are working on the feature - reduction of no. of stacks.

What is update stack operation?

Currently the process of updating stack is manual and no dynamic way of provisioning the same is available. This documents describes the programmatic way of achieving addition of new stacks.

Command

odin operate component --name YourApplicationComponentName --service YourServiceName --env YourEnvName --operation update-stack --options='{"num_lbs":YourDesiredNumberOfTotalStack,"auto_routing": false}'

Important: When using the num_lbs parameter in the options, remember to input the total number of stacks you want to end up with, not the number of stacks you want to add.

Option	Type	Descrption
operation	String	It takes the input of the operation you want to perform, in this case update-stack.
service	String	Service name for which the operation to be performed.
name	String	Application component name for which the operation to be performed.
env	String	Environment name where the operation is to be performed.
options	Json	num_lbs: This parameter will take the final no. of stacks that you want to achieve. E.g: If you want to add 2 stacks to your currently available 1 stack, hence value of this parameter would be 3. Please note, the value of num_lbs has to be higher than your current no. of stack. auto_routing: This parameter can take only one of these two values : True and False. Depending on your requirement, please select the value. Please note, if auto_routing is set to false, you have to manually route the traffic to the new stack. However, auto_routing, if set to true, will automatically start routing traffic to your new stack.

Frequently Asked Questions

1. How do I use auto_routing in option?

   It can take only one of these two values : True and False. Depending on your requirement, please select the value. Please note that if auto_routing is set to false, you have to manually route the traffic to the new stack. However, auto_routing, if set to true, will automatically start routing traffic to your new stack.

2. Can I reduce the number of stacks by providing the value of num_lbs lower than current no. of stacks?

   No. The value of num_lbs has to be higher than your current no. of stack.

3. Will I need to configure the newly made stacks as per my application?

   No, the stacks will be configured exactly as your current stack. You do not have to configure anything out of the box.

4. What do I do if I face any issue or get an error?

   If you are facing an issue with adding a stack, kindly raise an issue in #dss_odin_feedback.