@aws/nx-plugin-mcp 1.0.0-rc.86 → 1.0.0-rc.87
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/aws-nx-mcp.js
CHANGED
|
@@ -54023,7 +54023,7 @@ ${PACKAGE_MANAGERS.map((pm) => buildNxCommand("<options>", pm)).join(" - \n")}
|
|
|
54023
54023
|
- Generate all projects into the \`packages/\` directory
|
|
54024
54024
|
- After making changes to your projects, fix linting issues, then run a full build
|
|
54025
54025
|
- When it's time to start testing a project, suggest to the user that infrastructure is deployed to AWS. For websites, if a runtime-config.json is needed, use the load-runtime-config target after a deployment to point a local website at a sandbox stack.
|
|
54026
|
-
- For CDK infrastructure projects, deploy the sandbox stage with the \`deploy-sandbox\` target (eg \`nx deploy-sandbox infra\`) rather than passing a stage pattern to \`deploy\` — it already targets the sandbox stage declared in \`main.ts\`.
|
|
54026
|
+
- For CDK infrastructure projects, deploy the sandbox stage with the \`deploy-sandbox\` target (eg \`nx deploy-sandbox infra\`) rather than passing a stage pattern to \`deploy\` — it already targets the sandbox stage declared in \`main.ts\`. Likewise \`destroy-sandbox\` tears that stage back down.
|
|
54027
54027
|
|
|
54028
54028
|
## Batching Generators
|
|
54029
54029
|
|
|
@@ -269,7 +269,7 @@ export class GameApi<
|
|
|
269
269
|
pattern: 'isolated',
|
|
270
270
|
operations: routerToOperations(appRouter),
|
|
271
271
|
defaultIntegrationOptions: {
|
|
272
|
-
runtime: Runtime.
|
|
272
|
+
runtime: Runtime.NODEJS_24_X,
|
|
273
273
|
handler: 'index.handler',
|
|
274
274
|
code: Code.fromAsset(
|
|
275
275
|
url.fileURLToPath(
|
|
@@ -34,7 +34,7 @@ We recommend you try your hand at extending the codebase with the following capa
|
|
|
34
34
|
|
|
35
35
|
1. To destroy the AWS resources that were created, run the following command:
|
|
36
36
|
|
|
37
|
-
<NxCommands commands={['destroy infra
|
|
37
|
+
<NxCommands commands={['destroy-sandbox infra']} />
|
|
38
38
|
|
|
39
39
|
This will prompt you for a list of stacks to delete which should comprise of the `dungeon-adventure-infra-sandbox/Application/GameUI/waf` and `dungeon-adventure-infra-sandbox/Application`.
|
|
40
40
|
|
|
@@ -117,6 +117,12 @@ Finally, verify everything still builds, then delete `migrations.json` and commi
|
|
|
117
117
|
|
|
118
118
|
<PackageManagerShortCommand commands={['build']} />
|
|
119
119
|
|
|
120
|
+
<Aside type="caution" title="Some infrastructure changes are not migrated">
|
|
121
|
+
Migrations don't cover every change to the infrastructure we vend. Where updating an already-deployed stack would fail or destroy data, no migration is provided — your workspace keeps deploying the resources it deploys today, while a newly generated workspace gets the newer shape.
|
|
122
|
+
|
|
123
|
+
To pick those changes up, compare your infrastructure against what today's generators produce and apply the parts you want by hand, taking care over the deployment path for your existing resources.
|
|
124
|
+
</Aside>
|
|
125
|
+
|
|
120
126
|
## Upgrading with an AI agent
|
|
121
127
|
|
|
122
128
|
The whole flow can be driven by an AI coding agent end to end — nothing blocks on an interactive terminal. When `nx migrate --run-migrations` runs from inside an agent, Nx detects this, skips the agentic consent prompt, and instead of spawning a nested agent it **defers** each prompt migration back to the agent driving the run:
|
|
@@ -102,7 +102,7 @@ new ApplicationStage(app, 'my-app-sandbox', {
|
|
|
102
102
|
|
|
103
103
|
The `env` property tells CDK which AWS account and region to deploy to. `CDK_DEFAULT_ACCOUNT` and `CDK_DEFAULT_REGION` are resolved automatically by the CDK CLI from your active AWS credentials. See the [CDK environments documentation](https://docs.aws.amazon.com/cdk/v2/guide/environments.html) for more details.
|
|
104
104
|
|
|
105
|
-
The sandbox stage is the one the <Link path="guides/typescript-infrastructure#deploying-your-sandbox-stage">`deploy-sandbox
|
|
105
|
+
The sandbox stage is the one the <Link path="guides/typescript-infrastructure#deploying-your-sandbox-stage">`deploy-sandbox`</Link> and <Link path="guides/typescript-infrastructure#tearing-down-your-sandbox-stage">`destroy-sandbox`</Link> targets act on.
|
|
106
106
|
|
|
107
107
|
If you generated with `stageConfig`, the `main.ts` reads account and region from a centralized config file instead, falling back to environment variables when no config is set:
|
|
108
108
|
|
|
@@ -421,10 +421,34 @@ This target differs slightly from the regular `deploy` target in that it deploys
|
|
|
421
421
|
|
|
422
422
|
## Tearing Down AWS Infrastructure
|
|
423
423
|
|
|
424
|
-
|
|
424
|
+
Your project has three destroy targets, mirroring the deploy ones:
|
|
425
|
+
|
|
426
|
+
| Target | Use it for |
|
|
427
|
+
| ----------------- | ------------------------------------------------------------------------- |
|
|
428
|
+
| `destroy-sandbox` | Tearing down your own sandbox stage. No stage argument needed. |
|
|
429
|
+
| `destroy` | Tearing down any stage, by naming the stage or stacks you want. |
|
|
430
|
+
| `destroy-ci` | Tearing down from a CI/CD pipeline, using a pre-synthesized cloud assembly. |
|
|
431
|
+
|
|
432
|
+
### Tearing Down your Sandbox Stage
|
|
433
|
+
|
|
434
|
+
The `destroy-sandbox` target tears down the sandbox stage that `main.ts` declares, so you don't need to remember its stage name:
|
|
435
|
+
|
|
436
|
+
<NxCommands commands={['destroy-sandbox <my-infra>']} />
|
|
437
|
+
|
|
438
|
+
Destroying is irreversible, so CDK asks you to confirm the stacks it is about to delete. Pass `--force` to skip that confirmation, which is what you want when there is no terminal attached (in a script, say):
|
|
439
|
+
|
|
440
|
+
<NxCommands commands={['destroy-sandbox <my-infra> --force']} />
|
|
441
|
+
|
|
442
|
+
### Tearing Down a Specific Stage
|
|
443
|
+
|
|
444
|
+
The `destroy` target tears down whichever stage or stacks you name:
|
|
425
445
|
|
|
426
446
|
<NxCommands commands={['destroy <my-infra> <my-infra>-sandbox/*']} />
|
|
427
447
|
|
|
448
|
+
To tear down an individual stack, give the full stack name:
|
|
449
|
+
|
|
450
|
+
<NxCommands commands={['destroy <my-infra> <my-infra>-sandbox/Application']} />
|
|
451
|
+
|
|
428
452
|
## More Information
|
|
429
453
|
|
|
430
454
|
For more information about CDK, please refer to the [CDK Developer Guide](https://docs.aws.amazon.com/cdk/v2/guide/core_concepts.html) and [API Reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-construct-library.html).
|