@geek-fun/serverlessinsight 0.9.4 → 0.9.5

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.
Files changed (76) hide show
  1. package/AGENTS.md +5 -2
  2. package/CHANGELOG.md +28 -0
  3. package/README.md +26 -6
  4. package/README.zh-CN.md +26 -6
  5. package/codecov +0 -0
  6. package/codecov.SHA256SUM +1 -1
  7. package/codecov.SHA256SUM.sig +13 -13
  8. package/dist/package.json +1 -1
  9. package/dist/src/commands/deploy.js +7 -2
  10. package/dist/src/commands/destroy.js +6 -3
  11. package/dist/src/commands/forceUnlock.js +16 -21
  12. package/dist/src/commands/index.js +14 -4
  13. package/dist/src/commands/migrate.js +105 -132
  14. package/dist/src/commands/plan.js +2 -2
  15. package/dist/src/commands/show.js +17 -6
  16. package/dist/src/common/aggregateState.js +185 -0
  17. package/dist/src/common/aggregateStore.js +247 -0
  18. package/dist/src/common/apiClient.js +35 -12
  19. package/dist/src/common/constants.js +2 -1
  20. package/dist/src/common/context.js +22 -15
  21. package/dist/src/common/effectiveConfig.js +48 -0
  22. package/dist/src/common/index.js +5 -0
  23. package/dist/src/common/jsonOutput.js +2 -13
  24. package/dist/src/common/migrationMarker.js +0 -7
  25. package/dist/src/common/nameBuilder.js +2 -3
  26. package/dist/src/common/regionalMigration.js +261 -0
  27. package/dist/src/common/saasProtocol.js +41 -0
  28. package/dist/src/common/stateBackend/cosStateBackend.js +88 -8
  29. package/dist/src/common/stateBackend/index.js +42 -18
  30. package/dist/src/common/stateBackend/localStateBackend.js +61 -26
  31. package/dist/src/common/stateBackend/ossStateBackend.js +62 -9
  32. package/dist/src/common/stateBackend/remoteStateBackend.js +94 -94
  33. package/dist/src/common/stateBackend/saasStateBackend.js +327 -92
  34. package/dist/src/common/stateBackend/types.js +9 -0
  35. package/dist/src/common/stateManager.js +38 -11
  36. package/dist/src/common/stateScope.js +34 -0
  37. package/dist/src/common/stateStorageIO.js +31 -0
  38. package/dist/src/lang/en.js +43 -2
  39. package/dist/src/lang/zh-CN.js +43 -2
  40. package/dist/src/parser/index.js +25 -4
  41. package/dist/src/stack/aliyunStack/deployer.js +5 -5
  42. package/dist/src/stack/aliyunStack/destroyer.js +5 -5
  43. package/dist/src/stack/aliyunStack/fc3Planner.js +1 -1
  44. package/dist/src/stack/aliyunStack/fc3Resource.js +2 -2
  45. package/dist/src/stack/aliyunStack/planner.js +1 -1
  46. package/dist/src/stack/aliyunStack/sharedLogProject.js +2 -2
  47. package/dist/src/stack/ownershipTag.js +34 -26
  48. package/dist/src/stack/scfStack/deployer.js +5 -5
  49. package/dist/src/stack/scfStack/destroyer.js +5 -6
  50. package/dist/src/stack/scfStack/planner.js +1 -1
  51. package/dist/src/stack/scfStack/scfResource.js +1 -1
  52. package/dist/src/stack/scfStack/sharedLogset.js +5 -2
  53. package/dist/src/stack/volcengineStack/deployer.js +3 -3
  54. package/dist/src/stack/volcengineStack/destroyer.js +2 -3
  55. package/dist/src/stack/volcengineStack/planner.js +1 -1
  56. package/dist/src/stack/volcengineStack/sharedLogProject.js +4 -4
  57. package/dist/src/stack/volcengineStack/vefaasResource.js +1 -1
  58. package/dist/src/types/domains/state.js +28 -2
  59. package/dist/src/validator/rootSchema.js +8 -0
  60. package/dist/tsconfig.tsbuildinfo +1 -1
  61. package/package.json +1 -1
  62. package/release-notes.md +29 -32
  63. package/samples/README_TENCENT_COS.md +65 -23
  64. package/samples/README_TENCENT_SCF.md +44 -26
  65. package/.serverlessinsight/state-cdn-flow-app-cdn-flow-service.json.backup +0 -14
  66. package/.serverlessinsight/state-iam-test-app-iam-test-service.json.backup +0 -32
  67. package/.serverlessinsight/state-insight-poc-app-insight-poc-tencent.json.backup +0 -90
  68. package/.serverlessinsight/state-insight-poc-app-log-insight-poc-tencent-log.json.backup +0 -118
  69. package/.serverlessinsight/state-insight-poc-deploy-app-insight-poc-deploy.json.backup +0 -215
  70. package/.serverlessinsight/state-insight-poc-destroy-app-insight-poc-destroy.json.backup +0 -14
  71. package/.serverlessinsight/state-insight-poc-timer-app-insight-poc-timer.json.backup +0 -132
  72. package/.serverlessinsight/state-insight-volc-app-insight-volc.json.backup +0 -55
  73. package/.serverlessinsight/state-insight-volc-destroy-app-insight-volc-destroy.json.backup +0 -1
  74. package/.serverlessinsight/state-insight-volc-nested-app-insight-volc-nested.json.backup +0 -93
  75. package/.serverlessinsight/state-nested-drift-app-nested-drift-service.json.backup +0 -163
  76. package/.serverlessinsight/state-role-reconcile-test-app-role-reconcile-test-service.json.backup +0 -148
@@ -10,7 +10,7 @@ const tdsqlcPlanner_1 = require("./tdsqlcPlanner");
10
10
  const esServerlessPlanner_1 = require("./esServerlessPlanner");
11
11
  const generateTencentPlan = async (iac, backend) => {
12
12
  const context = (0, common_1.getContext)();
13
- const state = await backend.loadState(iac.provider.name, iac.app, iac.service, context.stage);
13
+ const state = await backend.loadState();
14
14
  const functionPlan = await (0, scfPlanner_1.generateFunctionPlan)(context, state, iac.functions);
15
15
  const bucketPlan = await (0, cosPlanner_1.generateBucketPlan)(context, state, iac.buckets);
16
16
  const databasePlan = await (0, tdsqlcPlanner_1.generateDatabasePlan)(context, state, iac.databases);
@@ -510,7 +510,7 @@ const createDependentResources = async (context, fn, existingInstances = [], sta
510
510
  }
511
511
  const hasCamRole = existingInstances.some((i) => i.type === 'TENCENT_SCF_ROLE');
512
512
  const serviceName = `${context.app}-${context.service}`;
513
- const defaultRoleName = (0, common_1.buildFunctionRoleName)(serviceName, context.stage, fn.key);
513
+ const defaultRoleName = (0, common_1.buildFunctionRoleName)(serviceName, context.stage, context.region, fn.key);
514
514
  const roleName = customRoleName ?? defaultRoleName;
515
515
  const executionStatements = (0, exports.deriveScfExecutionStatements)(fn, context, await client.cam.getOwnerUin(), clsConfig?.topicId);
516
516
  if (hasCamRole) {
@@ -50,14 +50,17 @@ const ensureSharedLogset = async (context, client, state) => {
50
50
  // untagged logset is refused rather than silently taken over or retagged.
51
51
  const existing = await client.cls.getLogsetByName(logsetName);
52
52
  if (existing?.LogsetId) {
53
- if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOGSET_KEY, existing.Tags)) {
53
+ if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOGSET_KEY, existing.Tags, context.region)) {
54
54
  throw new Error(lang_1.lang.__('CLS_LOGSET_FOREIGN_OWNED', { logsetName }));
55
55
  }
56
56
  return { logsetName, logsetId: existing.LogsetId };
57
57
  }
58
58
  logger_1.logger.info(lang_1.lang.__('CREATING_CLS_LOGSET', { logsetName }));
59
59
  const created = await client.cls.createLogset(logsetName, [
60
- { key: ownershipTag_1.OWNERSHIP_TAG_KEY, value: (0, ownershipTag_1.buildSharedOwnershipTagValue)(context.app, exports.SHARED_LOGSET_KEY) },
60
+ {
61
+ key: ownershipTag_1.OWNERSHIP_TAG_KEY,
62
+ value: (0, ownershipTag_1.buildSharedOwnershipTagValue)(context.app, exports.SHARED_LOGSET_KEY, context.region),
63
+ },
61
64
  ]);
62
65
  return { logsetName, logsetId: created.logsetId };
63
66
  };
@@ -41,10 +41,10 @@ const partitionPlan = (plan, types) => ({
41
41
  const deployVolcengineStack = async (iac, backend, approvedPlan) => {
42
42
  const context = (0, common_1.getContext)();
43
43
  common_1.logger.info(lang_1.lang.__('DEPLOYING_STACK'));
44
- let state = await backend.loadState('volcengine', iac.app, iac.service, context.stage);
44
+ let state = await backend.loadState();
45
45
  const onStateChange = async (newState) => {
46
46
  state = newState;
47
- await backend.saveState(state, iac.app, iac.service, context.stage);
47
+ await backend.saveState(state);
48
48
  };
49
49
  common_1.logger.info(lang_1.lang.__('GENERATING_PLAN'));
50
50
  const functionPlan = approvedPlan
@@ -105,7 +105,7 @@ const deployVolcengineStack = async (iac, backend, approvedPlan) => {
105
105
  })}`);
106
106
  throw error;
107
107
  }
108
- await backend.saveState(apigwResult.state, iac.app, iac.service, context.stage);
108
+ await backend.saveState(apigwResult.state);
109
109
  common_1.logger.info(lang_1.lang.__('STACK_DEPLOYED'));
110
110
  };
111
111
  exports.deployVolcengineStack = deployVolcengineStack;
@@ -11,12 +11,11 @@ const apigwResource_1 = require("./apigwResource");
11
11
  const sharedLogProject_1 = require("./sharedLogProject");
12
12
  const destroyVolcengineStack = async (backend) => {
13
13
  const context = (0, common_1.getContext)();
14
- const providerName = common_1.ProviderEnum.VOLCENGINE;
15
14
  common_1.logger.info(lang_1.lang.__('DESTROYING_STACK', {
16
15
  provider: context.provider,
17
16
  region: context.region,
18
17
  }));
19
- let state = await backend.loadState(providerName, context.app, context.service, context.stage);
18
+ let state = await backend.loadState();
20
19
  const allResources = (0, stateManager_1.getAllResources)(state);
21
20
  const eventEntries = Object.entries(allResources).filter(([logicalId, resourceState]) => logicalId.startsWith('events.') &&
22
21
  resourceState.instances?.some((i) => typeof i.type === 'string' && i.type.startsWith('VOLCENGINE_APIGW_')));
@@ -79,6 +78,6 @@ const destroyVolcengineStack = async (backend) => {
79
78
  state = (0, stateManager_1.removeSharedResource)(state, context.stage, 'logs.project');
80
79
  }
81
80
  }
82
- await backend.saveState(state, context.app, context.service, context.stage);
81
+ await backend.saveState(state);
83
82
  };
84
83
  exports.destroyVolcengineStack = destroyVolcengineStack;
@@ -8,7 +8,7 @@ const tosPlanner_1 = require("./tosPlanner");
8
8
  const apigwPlanner_1 = require("./apigwPlanner");
9
9
  const generateVolcenginePlan = async (iac, backend) => {
10
10
  const context = (0, common_1.getContext)();
11
- const state = await backend.loadState('volcengine', context.app, context.service, context.stage);
11
+ const state = await backend.loadState();
12
12
  const functionPlan = await (0, vefaasPlanner_1.generateFunctionPlan)(context, state, iac.functions);
13
13
  const bucketPlan = await (0, tosPlanner_1.generateBucketPlan)(context, state, iac.buckets);
14
14
  const apigwPlan = await (0, apigwPlanner_1.generateApigwPlan)(context, state, iac.events, iac.service);
@@ -35,7 +35,7 @@ const ensureSharedLogProject = async (context, client, state) => {
35
35
  const existing = await client.tls.getProject(projectName);
36
36
  if (existing?.projectId) {
37
37
  const tags = await client.tls.getProjectTags(projectName);
38
- if ((0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags)) {
38
+ if ((0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags, context.region)) {
39
39
  return { projectName, projectId: existing.projectId };
40
40
  }
41
41
  throw new Error(lang_1.lang.__('TLS_SHARED_PROJECT_NOT_OWNED', { projectName }));
@@ -58,7 +58,7 @@ const ensureSharedLogProject = async (context, client, state) => {
58
58
  tags: [
59
59
  {
60
60
  key: ownershipTag_1.OWNERSHIP_TAG_KEY,
61
- value: (0, ownershipTag_1.buildSharedOwnershipTagValue)(context.app, exports.SHARED_LOG_PROJECT_KEY),
61
+ value: (0, ownershipTag_1.buildSharedOwnershipTagValue)(context.app, exports.SHARED_LOG_PROJECT_KEY, context.region),
62
62
  },
63
63
  ],
64
64
  });
@@ -68,7 +68,7 @@ const ensureSharedLogProject = async (context, client, state) => {
68
68
  // ownership before adopting — an untagged or foreign project must not be
69
69
  // silently taken over.
70
70
  const tags = await client.tls.getProjectTags(projectName);
71
- if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags)) {
71
+ if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags, context.region)) {
72
72
  throw new Error(lang_1.lang.__('TLS_SHARED_PROJECT_NOT_OWNED', { projectName }));
73
73
  }
74
74
  }
@@ -110,7 +110,7 @@ const releaseSharedLogProjectIfUnused = async (context, client, shared) => {
110
110
  // Never delete a project that is not provably this app's — the ownership tag
111
111
  // proves the shared container belongs to us before teardown.
112
112
  const tags = await client.tls.getProjectTags(projectName);
113
- if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags)) {
113
+ if (!(0, ownershipTag_1.isOwnedByApp)(context.app, exports.SHARED_LOG_PROJECT_KEY, tags, context.region)) {
114
114
  logger_1.logger.warn(lang_1.lang.__('TLS_SHARED_PROJECT_NOT_OWNED', { projectName }));
115
115
  return 'retained';
116
116
  }
@@ -364,7 +364,7 @@ const createDependentResources = async (context, fn, serviceName, existingInstan
364
364
  // sharedInstance so log resources are tracked and torn down correctly.
365
365
  return { logConfig, role, instances, sharedInstance };
366
366
  }
367
- const roleName = customRoleName ?? (0, common_1.buildFunctionRoleName)(serviceName, context.stage, fn.key);
367
+ const roleName = customRoleName ?? (0, common_1.buildFunctionRoleName)(serviceName, context.stage, context.region, fn.key);
368
368
  const trustedServices = (0, vefaasTypes_1.getTrustedServicesForFunction)(fn, context);
369
369
  const executionStatements = (0, vefaasTypes_1.deriveVefaasExecutionStatements)(fn, context);
370
370
  if (hasIamRole) {
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.StateVersionError = exports.StateCorruptError = exports.PartialResourceError = exports.CURRENT_STATE_VERSION = exports.ResourceTypeEnum = void 0;
3
+ exports.StateRegionRequiredError = exports.StateScopeMismatchError = exports.StateVersionError = exports.StateCorruptError = exports.PartialResourceError = exports.LEGACY_STATE_VERSION = exports.CURRENT_STATE_VERSION = exports.ResourceTypeEnum = void 0;
4
4
  var ResourceTypeEnum;
5
5
  (function (ResourceTypeEnum) {
6
6
  // Tencent Cloud
@@ -40,7 +40,8 @@ var ResourceTypeEnum;
40
40
  ResourceTypeEnum["VOLCENGINE_VEFAAS_FUNCTION"] = "VOLCENGINE_VEFAAS_FUNCTION";
41
41
  ResourceTypeEnum["VOLCENGINE_TOS_BUCKET"] = "VOLCENGINE_TOS_BUCKET";
42
42
  })(ResourceTypeEnum || (exports.ResourceTypeEnum = ResourceTypeEnum = {}));
43
- exports.CURRENT_STATE_VERSION = '3.0';
43
+ exports.CURRENT_STATE_VERSION = '4.0';
44
+ exports.LEGACY_STATE_VERSION = '3.0';
44
45
  class PartialResourceError extends Error {
45
46
  updatedState;
46
47
  cause;
@@ -78,3 +79,28 @@ class StateVersionError extends Error {
78
79
  }
79
80
  }
80
81
  exports.StateVersionError = StateVersionError;
82
+ class StateScopeMismatchError extends Error {
83
+ requested;
84
+ stored;
85
+ constructor(requested, stored) {
86
+ super(`State identity mismatch: the stored state belongs to ` +
87
+ `provider=${stored.provider ?? 'unknown'}, app=${stored.app ?? 'unknown'}, ` +
88
+ `service=${stored.service ?? 'unknown'}, stage=${stored.stage ?? 'unknown'}, ` +
89
+ `region=${stored.region ?? 'unknown'}, but the command requested ` +
90
+ `provider=${requested.provider}, app=${requested.app}, service=${requested.service}, ` +
91
+ `stage=${requested.stage}, region=${requested.region}. ` +
92
+ 'Refusing to mix deployment scopes; check --stage/--region/--provider.');
93
+ this.name = 'StateScopeMismatchError';
94
+ this.requested = requested;
95
+ this.stored = stored;
96
+ }
97
+ }
98
+ exports.StateScopeMismatchError = StateScopeMismatchError;
99
+ class StateRegionRequiredError extends Error {
100
+ constructor(stage) {
101
+ super(`A regional deployment state requires a canonical region, but none was resolved for stage "${stage}". ` +
102
+ 'Pass -r/--region explicitly or set provider.region in the YAML configuration.');
103
+ this.name = 'StateRegionRequiredError';
104
+ }
105
+ }
106
+ exports.StateRegionRequiredError = StateRegionRequiredError;
@@ -167,6 +167,14 @@ exports.rootSchema = {
167
167
  type: { type: 'string', enum: ['LOCAL', 'BUCKET_STORE', 'SAAS'] },
168
168
  bucket: { type: 'string', description: 'State bucket name (BUCKET_STORE only).' },
169
169
  key: { type: 'string', description: 'State object key (BUCKET_STORE only).' },
170
+ storageRegion: {
171
+ type: 'string',
172
+ description: 'Pin where state is stored (BUCKET_STORE only); explicit settings never change when the workload -r changes.',
173
+ },
174
+ storageProvider: {
175
+ type: 'string',
176
+ description: 'Provider SDK used for state storage (BUCKET_STORE only); defaults to the workload provider.',
177
+ },
170
178
  },
171
179
  required: ['type'],
172
180
  additionalProperties: false,
@@ -1 +1 @@
1
- {"root":["../src/index.ts","../src/commands/deploy.ts","../src/commands/destroy.ts","../src/commands/forceUnlock.ts","../src/commands/index.ts","../src/commands/local.ts","../src/commands/login.ts","../src/commands/logout.ts","../src/commands/migrate.ts","../src/commands/plan.ts","../src/commands/schema.ts","../src/commands/show.ts","../src/commands/validate.ts","../src/commands/whoami.ts","../src/common/apiClient.ts","../src/common/base64.ts","../src/common/bucketPolicy.ts","../src/common/certUtils.ts","../src/common/concurrency.ts","../src/common/constants.ts","../src/common/context.ts","../src/common/credentialStore.ts","../src/common/credentials.ts","../src/common/domainUtils.ts","../src/common/eventQueue.ts","../src/common/fileUtils.ts","../src/common/functionDefinition.ts","../src/common/getVersion.ts","../src/common/hashUtils.ts","../src/common/iacHelper.ts","../src/common/iamStatements.ts","../src/common/imsClient.ts","../src/common/index.ts","../src/common/jsonOutput.ts","../src/common/lockManager.ts","../src/common/logger.ts","../src/common/migrationMarker.ts","../src/common/nameBuilder.ts","../src/common/noColor.ts","../src/common/planCapabilities.ts","../src/common/planCompare.ts","../src/common/planFormatter.ts","../src/common/planRedaction.ts","../src/common/polling.ts","../src/common/providerEnum.ts","../src/common/providerNames.ts","../src/common/refreshCache.ts","../src/common/refreshPlanner.ts","../src/common/reportResourceEvent.ts","../src/common/requestHelper.ts","../src/common/retryUtils.ts","../src/common/runtimeMapper.ts","../src/common/scfClient.ts","../src/common/siCron.ts","../src/common/sidUtils.ts","../src/common/stateManager.ts","../src/common/throttleRetry.ts","../src/common/triggerMapper.ts","../src/common/aliyunClient/apigwOperations.ts","../src/common/aliyunClient/casOperations.ts","../src/common/aliyunClient/cdnOperations.ts","../src/common/aliyunClient/dnsOperations.ts","../src/common/aliyunClient/ecsOperations.ts","../src/common/aliyunClient/esOperations.ts","../src/common/aliyunClient/fc3Operations.ts","../src/common/aliyunClient/index.ts","../src/common/aliyunClient/nasOperations.ts","../src/common/aliyunClient/ossOperations.ts","../src/common/aliyunClient/ramOperations.ts","../src/common/aliyunClient/rdsOperations.ts","../src/common/aliyunClient/slsOperations.ts","../src/common/aliyunClient/tablestoreOperations.ts","../src/common/aliyunClient/types.ts","../src/common/dependencyGraph/graph.ts","../src/common/dependencyGraph/index.ts","../src/common/dependencyGraph/types.ts","../src/common/stateBackend/cosStateBackend.ts","../src/common/stateBackend/index.ts","../src/common/stateBackend/localStateBackend.ts","../src/common/stateBackend/lockUtils.ts","../src/common/stateBackend/ossStateBackend.ts","../src/common/stateBackend/remoteStateBackend.ts","../src/common/stateBackend/saasStateBackend.ts","../src/common/stateBackend/types.ts","../src/common/tencentClient/camOperations.ts","../src/common/tencentClient/clsOperations.ts","../src/common/tencentClient/cosOperations.ts","../src/common/tencentClient/dnspodOperations.ts","../src/common/tencentClient/esOperations.ts","../src/common/tencentClient/index.ts","../src/common/tencentClient/scfOperations.ts","../src/common/tencentClient/sslOperations.ts","../src/common/tencentClient/tdsqlcClusterMapper.ts","../src/common/tencentClient/tdsqlcOperations.ts","../src/common/tencentClient/types.ts","../src/common/volcengineClient/apigwOperations.ts","../src/common/volcengineClient/iamOperations.ts","../src/common/volcengineClient/index.ts","../src/common/volcengineClient/stsOperations.ts","../src/common/volcengineClient/tlsOperations.ts","../src/common/volcengineClient/tosOperations.ts","../src/common/volcengineClient/types.ts","../src/common/volcengineClient/vefaasOperations.ts","../src/lang/en.ts","../src/lang/index.ts","../src/lang/zh-CN.ts","../src/parser/bucketParser.ts","../src/parser/databaseParser.ts","../src/parser/eventParser.ts","../src/parser/functionParser.ts","../src/parser/index.ts","../src/parser/parseUtils.ts","../src/parser/tableParser.ts","../src/parser/tagParser.ts","../src/stack/alreadyExists.ts","../src/stack/bucketTypes.ts","../src/stack/deploy.ts","../src/stack/index.ts","../src/stack/ownershipTag.ts","../src/stack/aliyunStack/apigwDomainPlan.ts","../src/stack/aliyunStack/apigwExecutor.ts","../src/stack/aliyunStack/apigwPlanner.ts","../src/stack/aliyunStack/apigwResource.ts","../src/stack/aliyunStack/apigwTypes.ts","../src/stack/aliyunStack/databaseExecutor.ts","../src/stack/aliyunStack/databasePlanner.ts","../src/stack/aliyunStack/databaseResource.ts","../src/stack/aliyunStack/deployer.ts","../src/stack/aliyunStack/destroyer.ts","../src/stack/aliyunStack/esServerlessTypes.ts","../src/stack/aliyunStack/fc3Executor.ts","../src/stack/aliyunStack/fc3Planner.ts","../src/stack/aliyunStack/fc3Resource.ts","../src/stack/aliyunStack/fc3Types.ts","../src/stack/aliyunStack/index.ts","../src/stack/aliyunStack/ossExecutor.ts","../src/stack/aliyunStack/ossPlanner.ts","../src/stack/aliyunStack/ossResource.ts","../src/stack/aliyunStack/ossTypes.ts","../src/stack/aliyunStack/planner.ts","../src/stack/aliyunStack/rdsTypes.ts","../src/stack/aliyunStack/sharedLogProject.ts","../src/stack/aliyunStack/tablestoreExecutor.ts","../src/stack/aliyunStack/tablestorePlanner.ts","../src/stack/aliyunStack/tablestoreResource.ts","../src/stack/aliyunStack/tablestoreTypes.ts","../src/stack/localStack/aliyunFc.ts","../src/stack/localStack/bucket.ts","../src/stack/localStack/event.ts","../src/stack/localStack/function.ts","../src/stack/localStack/functionRunner.ts","../src/stack/localStack/httpAdapter.ts","../src/stack/localStack/httpError.ts","../src/stack/localStack/index.ts","../src/stack/localStack/legacyLambda.ts","../src/stack/localStack/localContext.ts","../src/stack/localStack/localRoute.ts","../src/stack/localStack/localRuntimes.ts","../src/stack/localStack/localServer.ts","../src/stack/localStack/requestBody.ts","../src/stack/localStack/requestId.ts","../src/stack/localStack/tencent.ts","../src/stack/localStack/timer.ts","../src/stack/localStack/utils.ts","../src/stack/localStack/volcengine.ts","../src/stack/rfsStack/function.ts","../src/stack/rfsStack/index.ts","../src/stack/scfStack/cosExecutor.ts","../src/stack/scfStack/cosPlanner.ts","../src/stack/scfStack/cosResource.ts","../src/stack/scfStack/cosTypes.ts","../src/stack/scfStack/deployer.ts","../src/stack/scfStack/destroyer.ts","../src/stack/scfStack/esServerlessExecutor.ts","../src/stack/scfStack/esServerlessPlanner.ts","../src/stack/scfStack/esServerlessResource.ts","../src/stack/scfStack/esServerlessTypes.ts","../src/stack/scfStack/index.ts","../src/stack/scfStack/planner.ts","../src/stack/scfStack/scfExecutor.ts","../src/stack/scfStack/scfHttpTrigger.ts","../src/stack/scfStack/scfPlanner.ts","../src/stack/scfStack/scfResource.ts","../src/stack/scfStack/scfTypes.ts","../src/stack/scfStack/sharedLogset.ts","../src/stack/scfStack/tdsqlcExecutor.ts","../src/stack/scfStack/tdsqlcPlanner.ts","../src/stack/scfStack/tdsqlcResource.ts","../src/stack/scfStack/tdsqlcTypes.ts","../src/stack/volcengineStack/apigwDomains.ts","../src/stack/volcengineStack/apigwExecutor.ts","../src/stack/volcengineStack/apigwPlanner.ts","../src/stack/volcengineStack/apigwResource.ts","../src/stack/volcengineStack/apigwTypes.ts","../src/stack/volcengineStack/deployer.ts","../src/stack/volcengineStack/destroyer.ts","../src/stack/volcengineStack/index.ts","../src/stack/volcengineStack/planner.ts","../src/stack/volcengineStack/sharedLogProject.ts","../src/stack/volcengineStack/tosExecutor.ts","../src/stack/volcengineStack/tosPlanner.ts","../src/stack/volcengineStack/tosResource.ts","../src/stack/volcengineStack/tosTypes.ts","../src/stack/volcengineStack/vefaasExecutor.ts","../src/stack/volcengineStack/vefaasPlanner.ts","../src/stack/volcengineStack/vefaasResource.ts","../src/stack/volcengineStack/vefaasTypes.ts","../src/types/assets.ts","../src/types/index.ts","../src/types/tablestore.d.ts","../src/types/domains/backend.ts","../src/types/domains/bucket.ts","../src/types/domains/context.ts","../src/types/domains/database.ts","../src/types/domains/event.ts","../src/types/domains/function.ts","../src/types/domains/lock.ts","../src/types/domains/provider.ts","../src/types/domains/resolvable.ts","../src/types/domains/state.ts","../src/types/domains/table.ts","../src/types/domains/tag.ts","../src/types/domains/vars.ts","../src/types/localStack/index.ts","../src/validator/bucketSchema.ts","../src/validator/databaseSchema.ts","../src/validator/eventSchema.ts","../src/validator/functionSchema.ts","../src/validator/iacSchema.ts","../src/validator/index.ts","../src/validator/rootSchema.ts","../src/validator/schemaExport.ts","../src/validator/semanticValidation.ts","../src/validator/tableschema.ts","../src/validator/templateRefSchema.ts"],"version":"6.0.3"}
1
+ {"root":["../src/index.ts","../src/commands/deploy.ts","../src/commands/destroy.ts","../src/commands/forceUnlock.ts","../src/commands/index.ts","../src/commands/local.ts","../src/commands/login.ts","../src/commands/logout.ts","../src/commands/migrate.ts","../src/commands/plan.ts","../src/commands/schema.ts","../src/commands/show.ts","../src/commands/validate.ts","../src/commands/whoami.ts","../src/common/aggregateState.ts","../src/common/aggregateStore.ts","../src/common/apiClient.ts","../src/common/base64.ts","../src/common/bucketPolicy.ts","../src/common/certUtils.ts","../src/common/concurrency.ts","../src/common/constants.ts","../src/common/context.ts","../src/common/credentialStore.ts","../src/common/credentials.ts","../src/common/domainUtils.ts","../src/common/effectiveConfig.ts","../src/common/eventQueue.ts","../src/common/fileUtils.ts","../src/common/functionDefinition.ts","../src/common/getVersion.ts","../src/common/hashUtils.ts","../src/common/iacHelper.ts","../src/common/iamStatements.ts","../src/common/imsClient.ts","../src/common/index.ts","../src/common/jsonOutput.ts","../src/common/lockManager.ts","../src/common/logger.ts","../src/common/migrationMarker.ts","../src/common/nameBuilder.ts","../src/common/noColor.ts","../src/common/planCapabilities.ts","../src/common/planCompare.ts","../src/common/planFormatter.ts","../src/common/planRedaction.ts","../src/common/polling.ts","../src/common/providerEnum.ts","../src/common/providerNames.ts","../src/common/refreshCache.ts","../src/common/refreshPlanner.ts","../src/common/regionalMigration.ts","../src/common/reportResourceEvent.ts","../src/common/requestHelper.ts","../src/common/retryUtils.ts","../src/common/runtimeMapper.ts","../src/common/saasProtocol.ts","../src/common/scfClient.ts","../src/common/siCron.ts","../src/common/sidUtils.ts","../src/common/stateManager.ts","../src/common/stateScope.ts","../src/common/stateStorageIO.ts","../src/common/throttleRetry.ts","../src/common/triggerMapper.ts","../src/common/aliyunClient/apigwOperations.ts","../src/common/aliyunClient/casOperations.ts","../src/common/aliyunClient/cdnOperations.ts","../src/common/aliyunClient/dnsOperations.ts","../src/common/aliyunClient/ecsOperations.ts","../src/common/aliyunClient/esOperations.ts","../src/common/aliyunClient/fc3Operations.ts","../src/common/aliyunClient/index.ts","../src/common/aliyunClient/nasOperations.ts","../src/common/aliyunClient/ossOperations.ts","../src/common/aliyunClient/ramOperations.ts","../src/common/aliyunClient/rdsOperations.ts","../src/common/aliyunClient/slsOperations.ts","../src/common/aliyunClient/tablestoreOperations.ts","../src/common/aliyunClient/types.ts","../src/common/dependencyGraph/graph.ts","../src/common/dependencyGraph/index.ts","../src/common/dependencyGraph/types.ts","../src/common/stateBackend/cosStateBackend.ts","../src/common/stateBackend/index.ts","../src/common/stateBackend/localStateBackend.ts","../src/common/stateBackend/lockUtils.ts","../src/common/stateBackend/ossStateBackend.ts","../src/common/stateBackend/remoteStateBackend.ts","../src/common/stateBackend/saasStateBackend.ts","../src/common/stateBackend/types.ts","../src/common/tencentClient/camOperations.ts","../src/common/tencentClient/clsOperations.ts","../src/common/tencentClient/cosOperations.ts","../src/common/tencentClient/dnspodOperations.ts","../src/common/tencentClient/esOperations.ts","../src/common/tencentClient/index.ts","../src/common/tencentClient/scfOperations.ts","../src/common/tencentClient/sslOperations.ts","../src/common/tencentClient/tdsqlcClusterMapper.ts","../src/common/tencentClient/tdsqlcOperations.ts","../src/common/tencentClient/types.ts","../src/common/volcengineClient/apigwOperations.ts","../src/common/volcengineClient/iamOperations.ts","../src/common/volcengineClient/index.ts","../src/common/volcengineClient/stsOperations.ts","../src/common/volcengineClient/tlsOperations.ts","../src/common/volcengineClient/tosOperations.ts","../src/common/volcengineClient/types.ts","../src/common/volcengineClient/vefaasOperations.ts","../src/lang/en.ts","../src/lang/index.ts","../src/lang/zh-CN.ts","../src/parser/bucketParser.ts","../src/parser/databaseParser.ts","../src/parser/eventParser.ts","../src/parser/functionParser.ts","../src/parser/index.ts","../src/parser/parseUtils.ts","../src/parser/tableParser.ts","../src/parser/tagParser.ts","../src/stack/alreadyExists.ts","../src/stack/bucketTypes.ts","../src/stack/deploy.ts","../src/stack/index.ts","../src/stack/ownershipTag.ts","../src/stack/aliyunStack/apigwDomainPlan.ts","../src/stack/aliyunStack/apigwExecutor.ts","../src/stack/aliyunStack/apigwPlanner.ts","../src/stack/aliyunStack/apigwResource.ts","../src/stack/aliyunStack/apigwTypes.ts","../src/stack/aliyunStack/databaseExecutor.ts","../src/stack/aliyunStack/databasePlanner.ts","../src/stack/aliyunStack/databaseResource.ts","../src/stack/aliyunStack/deployer.ts","../src/stack/aliyunStack/destroyer.ts","../src/stack/aliyunStack/esServerlessTypes.ts","../src/stack/aliyunStack/fc3Executor.ts","../src/stack/aliyunStack/fc3Planner.ts","../src/stack/aliyunStack/fc3Resource.ts","../src/stack/aliyunStack/fc3Types.ts","../src/stack/aliyunStack/index.ts","../src/stack/aliyunStack/ossExecutor.ts","../src/stack/aliyunStack/ossPlanner.ts","../src/stack/aliyunStack/ossResource.ts","../src/stack/aliyunStack/ossTypes.ts","../src/stack/aliyunStack/planner.ts","../src/stack/aliyunStack/rdsTypes.ts","../src/stack/aliyunStack/sharedLogProject.ts","../src/stack/aliyunStack/tablestoreExecutor.ts","../src/stack/aliyunStack/tablestorePlanner.ts","../src/stack/aliyunStack/tablestoreResource.ts","../src/stack/aliyunStack/tablestoreTypes.ts","../src/stack/localStack/aliyunFc.ts","../src/stack/localStack/bucket.ts","../src/stack/localStack/event.ts","../src/stack/localStack/function.ts","../src/stack/localStack/functionRunner.ts","../src/stack/localStack/httpAdapter.ts","../src/stack/localStack/httpError.ts","../src/stack/localStack/index.ts","../src/stack/localStack/legacyLambda.ts","../src/stack/localStack/localContext.ts","../src/stack/localStack/localRoute.ts","../src/stack/localStack/localRuntimes.ts","../src/stack/localStack/localServer.ts","../src/stack/localStack/requestBody.ts","../src/stack/localStack/requestId.ts","../src/stack/localStack/tencent.ts","../src/stack/localStack/timer.ts","../src/stack/localStack/utils.ts","../src/stack/localStack/volcengine.ts","../src/stack/rfsStack/function.ts","../src/stack/rfsStack/index.ts","../src/stack/scfStack/cosExecutor.ts","../src/stack/scfStack/cosPlanner.ts","../src/stack/scfStack/cosResource.ts","../src/stack/scfStack/cosTypes.ts","../src/stack/scfStack/deployer.ts","../src/stack/scfStack/destroyer.ts","../src/stack/scfStack/esServerlessExecutor.ts","../src/stack/scfStack/esServerlessPlanner.ts","../src/stack/scfStack/esServerlessResource.ts","../src/stack/scfStack/esServerlessTypes.ts","../src/stack/scfStack/index.ts","../src/stack/scfStack/planner.ts","../src/stack/scfStack/scfExecutor.ts","../src/stack/scfStack/scfHttpTrigger.ts","../src/stack/scfStack/scfPlanner.ts","../src/stack/scfStack/scfResource.ts","../src/stack/scfStack/scfTypes.ts","../src/stack/scfStack/sharedLogset.ts","../src/stack/scfStack/tdsqlcExecutor.ts","../src/stack/scfStack/tdsqlcPlanner.ts","../src/stack/scfStack/tdsqlcResource.ts","../src/stack/scfStack/tdsqlcTypes.ts","../src/stack/volcengineStack/apigwDomains.ts","../src/stack/volcengineStack/apigwExecutor.ts","../src/stack/volcengineStack/apigwPlanner.ts","../src/stack/volcengineStack/apigwResource.ts","../src/stack/volcengineStack/apigwTypes.ts","../src/stack/volcengineStack/deployer.ts","../src/stack/volcengineStack/destroyer.ts","../src/stack/volcengineStack/index.ts","../src/stack/volcengineStack/planner.ts","../src/stack/volcengineStack/sharedLogProject.ts","../src/stack/volcengineStack/tosExecutor.ts","../src/stack/volcengineStack/tosPlanner.ts","../src/stack/volcengineStack/tosResource.ts","../src/stack/volcengineStack/tosTypes.ts","../src/stack/volcengineStack/vefaasExecutor.ts","../src/stack/volcengineStack/vefaasPlanner.ts","../src/stack/volcengineStack/vefaasResource.ts","../src/stack/volcengineStack/vefaasTypes.ts","../src/types/assets.ts","../src/types/index.ts","../src/types/tablestore.d.ts","../src/types/domains/backend.ts","../src/types/domains/bucket.ts","../src/types/domains/context.ts","../src/types/domains/database.ts","../src/types/domains/event.ts","../src/types/domains/function.ts","../src/types/domains/lock.ts","../src/types/domains/provider.ts","../src/types/domains/resolvable.ts","../src/types/domains/state.ts","../src/types/domains/table.ts","../src/types/domains/tag.ts","../src/types/domains/vars.ts","../src/types/localStack/index.ts","../src/validator/bucketSchema.ts","../src/validator/databaseSchema.ts","../src/validator/eventSchema.ts","../src/validator/functionSchema.ts","../src/validator/iacSchema.ts","../src/validator/index.ts","../src/validator/rootSchema.ts","../src/validator/schemaExport.ts","../src/validator/semanticValidation.ts","../src/validator/tableschema.ts","../src/validator/templateRefSchema.ts"],"version":"6.0.3"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@geek-fun/serverlessinsight",
3
- "version": "0.9.4",
3
+ "version": "0.9.5",
4
4
  "description": "Full-lifecycle serverless IaC for Alibaba Cloud, Tencent Cloud and Volcengine — one YAML to define, deploy and operate functions, API gateways, storage and databases.",
5
5
  "homepage": "https://serverlessinsight.com",
6
6
  "main": "dist/src/index.js",
package/release-notes.md CHANGED
@@ -1,48 +1,45 @@
1
1
 
2
2
  ### 🔧 Changed
3
3
 
4
- - CLI help, README examples, command references and sample guides now promote
5
- `si diff` as the only planning command.
4
+ - Deployment state is now isolated per stage/provider/region: the first
5
+ deploy/destroy/migrate upgrades the legacy state file in place to a V4
6
+ aggregate (original backup kept), so deploying to a second region or
7
+ provider no longer touches another deployment's resources
8
+ ([#280](https://github.com/geek-fun/serverlessinsight/issues/280)). CLI
9
+ versions older than this release refuse the upgraded state — upgrade all
10
+ writers together.
11
+ - SaaS deployments now require a Console with regional scope enabled (scope
12
+ protocol 3) and fail closed with guidance against older servers
13
+ ([#280](https://github.com/geek-fun/serverlessinsight/issues/280)).
14
+
15
+ ### ✨ Added
16
+
17
+ - `--bind-unknown-region <region>` on `deploy`, `destroy` and `migrate` to
18
+ explicitly bind legacy state entries that carry no region evidence, instead
19
+ of letting the CLI guess where historical resources live
20
+ ([#280](https://github.com/geek-fun/serverlessinsight/issues/280)).
6
21
 
7
- ### 🗑 Removed
22
+ ### 🐛 Fixed
8
23
 
9
- - **Breaking:** `si plan` has been removed; `si diff` is now the sole CLI
10
- command for previewing deployment changes
11
- ([#271](https://github.com/geek-fun/serverlessinsight/issues/271)). Invoking
12
- `si plan` fails fast with a localized error directing to `si diff` before any
13
- cloud or state access. Migrate by replacing the command verb — `si diff`
14
- accepts the same options and arguments, exit codes (`0` no changes / `2`
15
- changes / `1` errors) and `--json` envelope (`planVersion: 1`) as the removed
16
- command.
24
+ - Console/server conflict messages (state or protocol conflicts) are now
25
+ shown verbatim instead of a generic "HTTP Error 409"
26
+ ([#280](https://github.com/geek-fun/serverlessinsight/issues/280)).
17
27
 
18
- ### 🐛 Fixed
28
+ ## 👥 Contributors
29
+
30
+ - **blankll** (1 commit)
31
+ - **seven** (1 commit)
19
32
 
20
- - Aliyun API Gateway plans now report each custom domain's binding and
21
- certificate fingerprint, and rewrite only the dimensions that changed.
22
- - Certificate-only and redirect updates skip DNS verification, and removing a
23
- domain deletes only the bindings and DNS records si owns, leaving foreign
24
- records intact.
25
- - CLI language detection now honors `SI_LANG`, normalizes `LC_ALL`/`LANG`, and
26
- no longer prints `chcp` errors on Linux and macOS.
27
33
 
28
34
  ---
29
35
 
30
36
  <details>
31
37
  <summary>📋 Full commit history</summary>
32
38
 
33
- _Changes from v0.9.3 to v0.9.4_
39
+ _Changes from v0.9.4 to v0.9.5_
34
40
 
35
- - ed3964a release: v0.9.4 (blankll, 18 minutes ago)
36
- - b7c9062 chore(metadata): restore npm keyword aliases (blankll, 25 minutes ago)
37
- - 5236bfe docs: optimize READMEs and sync GitHub About metadata (blankll, 36 minutes ago)
38
- - 9103c99 fix(cli): preserve unknown-command suggestions after plan removal (#271) (blankll, 9 hours ago)
39
- - 6980d77 fix(lang): make PLAN_COMMAND_NOT_SUPPORTED wording command-neutral (#271) (blankll, 10 hours ago)
40
- - 73ebe6f feat(cli)!: remove si plan in favor of si diff (#271) (blankll, 10 hours ago)
41
- - 9ecdb8b feat(cli): deprecate si plan in favor of si diff (#271) (blankll, 11 hours ago)
42
- - ef0bcc4 test(aliyun): cover gateway diff and repair edge cases (blankll, 26 hours ago)
43
- - 5e69d08 fix(aliyun): reconcile gateway domain diffs and targeted repairs (blankll, 2 days ago)
44
- - 1a6aaa8 fix(lang): robust locale detection with SI_LANG override, locale normalization and win32-only chcp (blankll, 2 days ago)
45
- - 95de73e docs(brand): regenerate brand.jpg at 16:9 from source image (blankll, 2 days ago)
41
+ - d1a757a release: v0.9.5 (blankll, 34 minutes ago)
42
+ - 288718e refactor(state): isolate provider and region deployments in aggregate state (#281) (seven, 40 minutes ago)
46
43
 
47
44
  </details>
48
45
 
@@ -50,4 +47,4 @@ _Changes from v0.9.3 to v0.9.4_
50
47
 
51
48
  ## 📦 Install
52
49
 
53
- `npm install -g @geek-fun/serverlessinsight@0.9.4`
50
+ `npm install -g @geek-fun/serverlessinsight@0.9.5`
@@ -6,7 +6,7 @@ This guide demonstrates how to use ServerlessInsight with Tencent Cloud COS buck
6
6
 
7
7
  The Tencent COS support provides full lifecycle management for cloud storage buckets with:
8
8
 
9
- - **State Management**: Local state tracking in `.serverlessinsight/state.json`
9
+ - **State Management**: Local state tracking in `.serverlessinsight/state-example-app-my-service.json`
10
10
  - **Plan & Apply Flow**: Preview changes before applying them
11
11
  - **Drift Detection**: Detect manual changes made outside ServerlessInsight
12
12
  - **Website Hosting**: Configure static website hosting
@@ -29,8 +29,13 @@ provider:
29
29
  name: tencent
30
30
  region: ap-guangzhou
31
31
 
32
+ app: example-app
32
33
  service: my-service
33
34
 
35
+ backend:
36
+ state_manager:
37
+ type: LOCAL
38
+
34
39
  buckets:
35
40
  my_bucket:
36
41
  name: my-unique-bucket-name-123456 # Must be globally unique
@@ -95,7 +100,7 @@ Output shows:
95
100
  Apply the infrastructure changes:
96
101
 
97
102
  ```bash
98
- si deploy my-stack \
103
+ si deploy \
99
104
  -f serverless-insight.yml \
100
105
  -r ap-guangzhou \
101
106
  -k YOUR_SECRET_ID \
@@ -106,37 +111,50 @@ The deploy command will:
106
111
 
107
112
  1. Generate a plan for all resources (functions + buckets)
108
113
  2. Execute the plan (create/update/delete buckets)
109
- 3. Save the state to `.serverlessinsight/state.json`
114
+ 3. Save the state to `.serverlessinsight/state-example-app-my-service.json`
110
115
 
111
116
  ### Validate
112
117
 
113
118
  Validate your YAML configuration:
114
119
 
115
120
  ```bash
116
- si validate my-stack -f serverless-insight.yml
121
+ si validate -f serverless-insight.yml
117
122
  ```
118
123
 
119
124
  ## State Management
120
125
 
121
- State is stored locally in `.serverlessinsight/state.json`:
126
+ With the explicit LOCAL backend above, state remains at
127
+ `.serverlessinsight/state-example-app-my-service.json`. The V4 aggregate contains
128
+ independent stage/provider/region partitions, for example after selecting `-s prod`:
122
129
 
123
130
  ```json
124
131
  {
125
- "version": "0.1",
126
- "provider": "tencent",
127
- "resources": {
128
- "buckets.my_bucket": {
129
- "type": "COS_BUCKET",
130
- "physicalId": "my-unique-bucket-name-123456",
131
- "region": "ap-guangzhou",
132
- "configHash": "abc123...",
133
- "lastUpdated": "2025-01-01T12:00:00Z"
132
+ "version": "4.0",
133
+ "app": "example-app",
134
+ "service": "my-service",
135
+ "stages": {
136
+ "prod": {
137
+ "providers": {
138
+ "tencent": {
139
+ "regions": {
140
+ "ap-guangzhou": {
141
+ "lineage": "deployment-uuid",
142
+ "serial": 1,
143
+ "resources": {},
144
+ "shared": {}
145
+ }
146
+ }
147
+ }
148
+ }
134
149
  }
135
150
  }
136
151
  }
137
152
  ```
138
153
 
139
- **Important**: Add `.serverlessinsight/` to your `.gitignore` if you don't want to commit state files.
154
+ The executor works with only the selected partition. Its native IDs and revision are
155
+ preserved when another provider/region is deployed. All partitions in this file share
156
+ one deployment lock. See [deployment state and migration](../docs/regional-deployment-state.md).
157
+ Keep state and credentials out of version control.
140
158
 
141
159
  ## Access Control (ACL)
142
160
 
@@ -185,6 +203,7 @@ buckets:
185
203
  security:
186
204
  acl: PUBLIC_READ # Website content must be publicly readable
187
205
  website:
206
+ code: ./public
188
207
  index: index.html # Default page (also used as error document for SPA routing)
189
208
  ```
190
209
 
@@ -206,8 +225,13 @@ provider:
206
225
  name: tencent
207
226
  region: ap-guangzhou
208
227
 
228
+ app: example-app
209
229
  service: my-full-app
210
230
 
231
+ backend:
232
+ state_manager:
233
+ type: LOCAL
234
+
211
235
  functions:
212
236
  api_function:
213
237
  name: my-api-function
@@ -224,6 +248,7 @@ buckets:
224
248
  security:
225
249
  acl: PUBLIC_READ
226
250
  website:
251
+ code: ./public
227
252
  index: index.html
228
253
  ```
229
254
 
@@ -233,10 +258,10 @@ Running `si deploy` multiple times with the same configuration is safe:
233
258
 
234
259
  ```bash
235
260
  # First run - creates the bucket
236
- si deploy my-stack -f serverless-insight.yml
261
+ si deploy -f serverless-insight.yml
237
262
 
238
263
  # Second run - detects no changes needed
239
- si deploy my-stack -f serverless-insight.yml
264
+ si deploy -f serverless-insight.yml
240
265
  ```
241
266
 
242
267
  ## Drift Detection
@@ -291,7 +316,7 @@ Run `si deploy` to apply the change.
291
316
 
292
317
  To delete a bucket, remove it from your YAML file and run deploy:
293
318
 
294
- ```yaml
319
+ ```text
295
320
  # Before
296
321
  buckets:
297
322
  my_bucket:
@@ -315,8 +340,13 @@ provider:
315
340
  name: tencent
316
341
  region: ap-guangzhou
317
342
 
343
+ app: example-app
318
344
  service: simple-bucket
319
345
 
346
+ backend:
347
+ state_manager:
348
+ type: LOCAL
349
+
320
350
  buckets:
321
351
  assets:
322
352
  name: my-assets-bucket-20250101
@@ -332,14 +362,20 @@ provider:
332
362
  name: tencent
333
363
  region: ap-guangzhou
334
364
 
365
+ app: example-app
335
366
  service: my-website
336
367
 
368
+ backend:
369
+ state_manager:
370
+ type: LOCAL
371
+
337
372
  buckets:
338
373
  website:
339
374
  name: my-website-bucket-20250101
340
375
  security:
341
376
  acl: PUBLIC_READ
342
377
  website:
378
+ code: ./public
343
379
  index: index.html
344
380
  ```
345
381
 
@@ -351,8 +387,13 @@ provider:
351
387
  name: tencent
352
388
  region: ap-guangzhou
353
389
 
390
+ app: example-app
354
391
  service: multi-bucket-app
355
392
 
393
+ backend:
394
+ state_manager:
395
+ type: LOCAL
396
+
356
397
  buckets:
357
398
  public_assets:
358
399
  name: public-assets-20250101
@@ -369,6 +410,7 @@ buckets:
369
410
  security:
370
411
  acl: PUBLIC_READ
371
412
  website:
413
+ code: ./public
372
414
  index: index.html
373
415
  ```
374
416
 
@@ -394,7 +436,7 @@ Error: `AuthFailure.SecretIdNotFound`
394
436
  export TENCENTCLOUD_SECRET_ID=your_secret_id
395
437
  export TENCENTCLOUD_SECRET_KEY=your_secret_key
396
438
 
397
- si deploy my-stack -f serverless-insight.yml
439
+ si deploy -f serverless-insight.yml
398
440
  ```
399
441
 
400
442
  ### Bucket Not Empty
@@ -421,10 +463,10 @@ If your website is not accessible after deployment:
421
463
 
422
464
  ### State File Conflicts
423
465
 
424
- If you encounter state conflicts, you can:
425
-
426
- 1. Delete `.serverlessinsight/state.json` and re-deploy (will recreate resources)
427
- 2. Manually edit the state file (advanced users only)
466
+ Keep the current state and backups. Confirm App/Service/Stage/Provider/Region and the
467
+ backend location, wait for the active writer, then refetch and re-plan. Write commands
468
+ automatically upgrade released V3 state in place; rerun the original operation to resume
469
+ an interrupted upgrade. Deleting or hand-editing state can lose sibling ownership.
428
470
 
429
471
  ## Limitations
430
472