Migrate from oxygenctl-action to Hydrogen CLI

Introducing the `deploy` command

The shopify/oxygenctl-action is being deprecated and all merchants are encouraged to migrate to the Hydrogen CLI deploy command

[!IMPORTANT] To use the deploy command, upgrade your Hydrogen project to use Hydrogen CLI v7.0.0 or later: npm install @shopify/cli-hydrogen@latest.

Understanding the code changes

This pull request will try to automate the migration for you but you might need to make manual changes. There are two important changes:

Migrate from shopify/oxygenctl-action to use npx shopify hydrogen deploy
Remove shopify/github-deployment-action

[!TIP] Try viewing the file changes with white space disabled, since there may be unrelated formatting changes.

Manual changes

If you've heavily modified your workflow file(s) and the diff generated by this pull request is too large, you can implement these changes yourself. Here are some simplified examples of the required updates:

Migrate from `shopify/oxygenctl-action` to `npx shopify hydrogen deploy`

  - name: Build and Publish to Oxygen
    id: deploy
-   uses: shopify/oxygenctl-action@v4
+   run: npx shopify hydrogen deploy
+   env:
+     SHOPIFY_HYDROGEN_DEPLOYMENT_TOKEN: ${{ secrets.OXYGEN_DEPLOYMENT_TOKEN_X }}
-   with:
-     oxygen_deployment_token: ${{ secrets.OXYGEN_DEPLOYMENT_TOKEN_X }}
-     build_command: "npm run build"

Remove `shopify/github-deployment-action`

- - name: Create GitHub Deployment
-   uses: shopify/github-deployment-action@v1
-   if: always()
-     with:
-       token: ${{ github.token }}
-       environment: 'preview'
-       preview_url: ${{ steps.deploy.outputs.url }}
-       description: ${{ github.event.head_commit.message }}

Troubleshooting

Command `hydrogen deploy` not found.error

The `deploy` command was publicly released with `@shopify/cli-hydrogen` v7.0.0. You'll need to update to v7.0.0 or later in order to use `deploy`. Learn more about the release in the [changelog](https://github.com/Shopify/hydrogen/blob/main/packages/cli/CHANGELOG.md#700).

Nonexistent flag error

The `--build-command` and `--no-verify` flags were released with `@shopify/cli-hydrogen` v7.1.0. If your workflow file includes those flags, you'll need to update to v7.1.0 or later to use them. Learn more about the release in the [changelog](https://github.com/Shopify/hydrogen/blob/main/packages/cli/CHANGELOG.md#710).

Jiagia / official-website