Change refresh behavior to use --refresh flag

CHANGELOG.md

@@ -2,6 +2,9 @@
 
 ## HEAD (Unreleased)
 
+- feat: (breaking change) Update the `refresh` option to runcommands with the
+ `--refresh` flag. ([#1118](https://github.com/pulumi/actions/pull/1118))
+
 ---
 
 ## 5.5.1 (2024-08-23)

README.md

@@ -20,7 +20,7 @@ jobs:
  runs-on: ubuntu-latest
  steps:
  - uses: actions/checkout@v4
- - uses: pulumi/actions@v5
+ - uses: pulumi/actions@v6
  with:
  command: preview
  stack-name: org-name/stack-name
@@ -60,8 +60,8 @@ The action can be configured with the following arguments:
 - `github-token` - (optional) A GitHub token that has access levels to allow the
  Action to comment on a PR. Defaults to `${{ github.token }}`
 
-- `refresh` - (optional) If `true`, stack is refreshed before running the
- `command`.
+- `refresh` - (optional) If `true`, `preview` and `up` commands are called with
+ the `--refresh` flag.
 
 - `secrets-provider` - (optional) The type of the provider that should be used
  to encrypt and decrypt secrets. Possible choices: `default`, `passphrase`,
@@ -165,7 +165,7 @@ If you want to only install the Pulumi CLI, omit the `command` field of the
 action.
 
 ```yaml
-- uses: pulumi/actions@v5
+- uses: pulumi/actions@v6
 ```
 
 This will install Pulumi and exit without performing any other operations.
@@ -199,7 +199,7 @@ We can see that `pet-name` is an output. To get the value of this output in the
 action, we would use code similar to the following:
 
 ```yaml
-- uses: pulumi/actions@v5
+- uses: pulumi/actions@v6
  id: pulumi
  env:
  PULUMI_CONFIG_PASSPHRASE: ${{ secrets.PULUMI_CONFIG_PASSPHRASE }}
@@ -248,6 +248,13 @@ Minor releases will be published around the beginning of the month. We may cut a
 patch release instead, if the changes are small enough not to warrant a minor
 release. We will also cut patch releases periodically as needed to address bugs.
 
+## Migrating from v5
+
+v6 of the Pulumi Action updates the behavior of the `refresh` option.
+Previously, if `refresh` was true, the action would run `pulumi refresh` before
+the desired command. In v6, the `pulumi up` and `pulumi preview` commands will
+be run with the `--refresh` flag if `refresh` is true.
+
 ## Migrating from v4
 
 v5 of the Pulumi Action updates the NodeJS runtime from Node 16 to Node 20.

action.yml

@@ -76,7 +76,7 @@ inputs:
  description: 'Path to JSON file containing the config for the policy pack of the corresponding "--policy-pack" flag.'
  required: false
  refresh:
- description: 'Perform a stack refresh as part of the operation'
+ description: 'Execute the operation with the `--refresh` option'
  required: false
  default: 'false'
  upsert:

src/__tests__/config.test.ts

@@ -59,6 +59,7 @@ describe('config.ts', () => {
  "plan": "",
  "policyPackConfigs": Array [],
  "policyPacks": Array [],
+ "refresh": false,
  "replace": Array [],
  "suppressOutputs": false,
  "suppressProgress": false,
@@ -67,7 +68,6 @@ describe('config.ts', () => {
  "userAgent": "pulumi/actions@v5",
  },
  "pulumiVersion": "^3",
- "refresh": false,
  "remove": false,
  "secretsProvider": "",
  "stackName": "dev",

src/config.ts

@@ -86,7 +86,6 @@ export function makeConfig() {
  commentOnSummary: getBooleanInput('comment-on-summary'),
  upsert: getBooleanInput('upsert'),
  remove: getBooleanInput('remove'),
- refresh: getBooleanInput('refresh'),
  // TODO: Add parser back once pulumi/pulumi#12641 is fixed.
  // @see https://github.com/pulumi/actions/pull/913
  // @see https://github.com/pulumi/actions/pull/912
@@ -99,6 +98,7 @@ export function makeConfig() {
  message: getInput('message'),
  expectNoChanges: getBooleanInput('expect-no-changes'),
  diff: getBooleanInput('diff'),
+ refresh: getBooleanInput('refresh'),
  replace: parseSemicolorToArray(getMultilineInput('replace')),
  target: parseSemicolorToArray(getMultilineInput('target')),
  targetDependents: getBooleanInput('target-dependents'),

src/main.ts

@@ -79,11 +79,6 @@ const runAction = async (config: Config): Promise<void> => {
  await stack.setAllConfig(config.configMap);
  }
 
- if (config.refresh) {
- core.startGroup(`Refresh stack on ${config.stackName}`);
- await stack.refresh({ onOutput });
- core.endGroup();
- }
 
  core.startGroup(`pulumi ${config.command} on ${config.stackName}`);