Skip to content

6425: Remove deploy script#6752

Open
ca61688 wants to merge 11 commits intodevelopfrom
6425-remove-deploy-sh-script
Open

6425: Remove deploy script#6752
ca61688 wants to merge 11 commits intodevelopfrom
6425-remove-deploy-sh-script

Conversation

@ca61688
Copy link
Collaborator

@ca61688 ca61688 commented Mar 5, 2026

Make sure you have checked all steps below.

Issue

Tests

  • My PR adds the following tests based on our test strategy OR does not need testing for this extremely good reason:
    • Script removal, no testing required

Documentation

  • In case of new functionality, my PR adds documentation that describes how to use it, or I have linked to a
    separate issue for that below.
  • If I have added new Java code, I have added Javadoc that explains it following our conventions and style.
  • If I have added or removed any dependencies from the project, I have updated the NOTICES file.

@ca61688 ca61688 linked an issue Mar 5, 2026 that may be closed by this pull request
@ca61688 ca61688 added the needs-reviewer Pull requests that need a reviewer to be assigned label Mar 12, 2026
@ca61688 ca61688 marked this pull request as ready for review March 12, 2026 14:19
| File | Purpose | Usecase |
|-----------------|--------------------------------|---------|
deployNew.sh | Deploys a new instance | Use When deploying a new instance
deployExisting.sh | Redeploys an existing instance | Use when you wish to re-run the CDK against an exising deployment, in case you're concerned there's drift. Or when you wish to upgrade and existing instance to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is the latter part of this use case necessary:

From "In case you're concerned..."

Copy link
Collaborator

@rtjd6554 rtjd6554 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just thought about if use case message is too much

@patchwork01 patchwork01 self-assigned this Mar 12, 2026
Copy link
Collaborator

@patchwork01 patchwork01 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The parts about removing the deploy.sh script look great, it looks like the only part left for that is to remove its section of the documentation, which currently has just had deploy.sh replaced with deployNew.sh.

For the other documentation changes, part of the idea was that we could make a more direct explanation of what the scripts do, with a description of the CDK commands they'll run and what else they do. There was a suggestion that could be in the table. I'm not sure if the purpose/use case setup is quite right. Do you want to adjust it or would you rather get it merged?


```bash
./scripts/deploy/deploy.sh <instance-id> <vpc-id> <subnet-ids> ./my-instance/instance.properties
./scripts/deploy/deployNew.sh <instance-id> <vpc-id> <subnet-ids> ./my-instance/instance.properties
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section isn't correct any more. It's specific to the deploy.sh script, and deployNew.sh is covered in other sections just above.

The description of this code example states this "will either create or update an instance, applying your configuration declaratively". The deployNew.sh script can only create and not update an instance.

| File | Purpose | Usecase |
|-----------------|--------------------------------|---------|
deployNew.sh | Deploys a new instance | Use When deploying a new instance
deployExisting.sh | Redeploys an existing instance | Use when you wish to re-run the CDK against an exising deployment, in case you're concerned there's drift. Or when you wish to upgrade and existing instance to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's a typo at "Use When ...", the second word shouldn't be capitalised.

| File | Purpose | Usecase |
|-----------------|--------------------------------|---------|
deployNew.sh | Deploys a new instance | Use When deploying a new instance
deployExisting.sh | Redeploys an existing instance | Use when you wish to re-run the CDK against an exising deployment, in case you're concerned there's drift. Or when you wish to upgrade and existing instance to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think it reads a bit oddly to start a sentence with "or" here.

| File | Purpose | Usecase |
|-----------------|--------------------------------|---------|
deployNew.sh | Deploys a new instance | Use When deploying a new instance
deployExisting.sh | Redeploys an existing instance | Use when you wish to re-run the CDK against an exising deployment, in case you're concerned there's drift. Or when you wish to upgrade and existing instance to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are typos at "scrips" and "uscases".


The `deployExisting.sh` script can be used to bring an existing instance up to date. This will upload any jars
that have changed, update all the docker images, and perform a `cdk deploy`.
The `deployExisting.sh` script can be used to re-run the CDK against an existing instance of sleeper or update it to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sleeper should be capitalised here.


The `deployExisting.sh` script can be used to bring an existing instance up to date. This will upload any jars
that have changed, update all the docker images, and perform a `cdk deploy`.
The `deployExisting.sh` script can be used to re-run the CDK against an existing instance of sleeper or update it to a newer version.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This implies that updating it to a newer version is something different from re-running the CDK, but it's a result of re-running the CDK.

@patchwork01 patchwork01 assigned ca61688 and unassigned patchwork01 Mar 12, 2026
@patchwork01 patchwork01 removed the needs-reviewer Pull requests that need a reviewer to be assigned label Mar 12, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Remove deploy.sh and document comparison between deployment modes

3 participants