End-to-end testing
Learn how to run end-to-end tests against your deployment in your CI/CD workflow by creating an authentication bypass token.
Step 1: Generate the authentication bypass token
Anchor link to section titled "Step 1: Generate the authentication bypass token"- Generate a deployment token in the Shopify admin.
- Modify your CI/CD file to include the deploy command.
- The command outputs a file named
h2_deploy_log.json
, which contains the deployment URL and the authentication bypass token that you can feed into your end-to-end testing system.
Token duration
Anchor link to section titled "Token duration"By default, tokens are valid for two hours. You can modify this duration by supplying the --auth-bypass-token-duration
flag to the deploy
command. The duration can be set to any whole number of hours from 1 to 12.
Example GitHub workflow
Anchor link to section titled "Example GitHub workflow"If you're using GitHub workflow files, then edit the deploy step per the following example. If you're using another CI/CD system, then refer to these example workflows.
Refer to a live example in the Hydrogen Demo Store.
Step 2: Embed the authentication bypass token in the request header
Anchor link to section titled "Step 2: Embed the authentication bypass token in the request header"Your end-to-end testing system must embed the token within the header before navigating to the deployment URL.