Skip to content

Commit

Permalink
chore: add wait-on-circle-workflows polling script for release automa…
Browse files Browse the repository at this point in the history
…tion (#25984)

Co-authored-by: Ryan Manuel <ryanm@cypress.io>
  • Loading branch information
emilyrohrbough and ryanthemanuel authored Mar 7, 2023
1 parent 434e6ee commit 89cc70d
Show file tree
Hide file tree
Showing 3 changed files with 242 additions and 1 deletion.
77 changes: 77 additions & 0 deletions .circleci/workflows.yml
Original file line number Diff line number Diff line change
Expand Up @@ -1300,6 +1300,29 @@ jobs:
PERCY_PARALLEL_NONCE=$CIRCLE_WORKFLOW_WORKSPACE_ID \
yarn percy build:finalize || yarn percy build:finalize
# a special job that keeps polling Circle and when all
# pipeline workflows are finished, it moves forward with the binary release
trigger-binary-release-workflow:
<<: *defaults
resource_class: small
parameters:
<<: *defaultsParameters
steps:
- restore_cached_workspace
- run:
name: 'Determine if Release Workflow should be triggered'
command: |
if [[ "$CIRCLE_BRANCH" != "develop" ]]; then
echo "Only move forward with the release when running on develop."
circleci-agent step halt
fi
- run:
name: "Wait for other Circle CI workflows to finish"
command: CIRCLE_PIPELINE_ID="<<pipeline.id>>" node ./scripts/wait-on-circle-workflows.js
- run:
name: Ready to release
command: echo 'Ready to release'

cli-visual-tests:
<<: *defaults
resource_class: small
Expand Down Expand Up @@ -2557,6 +2580,59 @@ linux-x64-workflow: &linux-x64-workflow
# This release definition must be updated with any new jobs
# Any attempts to automate this are welcome
# If CircleCI provided an "after all" hook, then this wouldn't be necessary
- trigger-binary-release-workflow:
context: test-runner:poll-circle-workflow
requires:
- build
- check-ts
- npm-angular
- npm-eslint-plugin-dev
- npm-create-cypress-tests
- npm-react
- npm-mount-utils
- npm-vue
- npm-webpack-batteries-included-preprocessor
- npm-webpack-preprocessor
- npm-vite-dev-server
- npm-webpack-dev-server
- npm-cypress-schematic
- lint-types
- linux-lint
- percy-finalize
- driver-integration-tests-firefox
- driver-integration-tests-chrome
- driver-integration-tests-chrome-beta
- driver-integration-tests-electron
- driver-integration-memory-tests
- system-tests-non-root
- system-tests-firefox
- system-tests-electron
- system-tests-chrome
- server-performance-tests
- server-integration-tests
- server-unit-tests
- "test binary as a non-root user"
- "test binary as a root user"
- test-types-cypress-and-jest
- test-full-typescript-project
- test-binary-against-kitchensink
- test-npm-module-on-minimum-node-version
- binary-system-tests
- test-kitchensink
- unit-tests
- verify-release-readiness
- cli-visual-tests
- reporter-integration-tests
- run-app-component-tests-chrome
- run-app-integration-tests-chrome
- run-frontend-shared-component-tests-chrome
- run-launchpad-component-tests-chrome
- run-launchpad-integration-tests-chrome
- run-reporter-component-tests-chrome
- run-webpack-dev-server-integration-tests
- run-vite-dev-server-integration-tests
- v8-integration-tests

- npm-release:
context: test-runner:npm-release
requires:
Expand All @@ -2580,6 +2656,7 @@ linux-x64-workflow: &linux-x64-workflow
- driver-integration-tests-chrome
- driver-integration-tests-chrome-beta
- driver-integration-tests-electron
- driver-integration-memory-tests
- system-tests-non-root
- system-tests-firefox
- system-tests-electron
Expand Down
2 changes: 1 addition & 1 deletion scripts/wait-on-circle-jobs.js
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ const waitForAllJobs = async (jobNames, workflowId) => {
const jobsToWaitFor = _.intersection(jobNames, futureOrRunning)

// logging something every time this runs will avoid CI timing out if there is no activity for 10 mins.
console.log(`waiting for jobs, jobs outstanding: ${response.items.length}`)
console.log(`waiting for jobs, jobs outstanding: ${jobsToWaitFor.length}`)

debug('jobs to wait for %o', jobsToWaitFor)

Expand Down
164 changes: 164 additions & 0 deletions scripts/wait-on-circle-workflows.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,164 @@
/* eslint-disable no-console */

const _ = require('lodash')
const Promise = require('bluebird')
const retry = require('bluebird-retry')
const got = require('got')

const { seconds, minutes } = require('./utils')

const WORKFLOW_NAMES = [
'darwin-arm64',
'darwin-x64',
'linux-arm64',
// 'linux-x64', this is the workflow validating this check so leaved commented out
'windows',
'setup-workflow',
]

const pipelineId = process.env.CIRCLE_PIPELINE_ID // pulled from <pipeline.id> circleci parameter

const getAuth = () => `${process.env.CIRCLE_TOKEN}:`

const verifyCI = () => {
if (!process.env.CIRCLE_TOKEN) {
console.error('Cannot find CIRCLE_TOKEN')
process.exit(1)
}

if (!process.env.CIRCLE_PIPELINE_ID) {
console.error('Cannot find CIRCLE_WORKFLOW_ID')
process.exit(1)
}

if (process.env.CIRCLE_BRANCH !== 'develop') {
console.error('Only move forward with the release when running on develop.')
process.exit(1)
}
}

const getWorkflows = async () => {
const auth = getAuth()
// typo at https://circleci.com/docs/2.0/api-intro/
// to retrieve all jobs, the url is "/pipeline/:id/workflow"
const url = `https://${auth}@circleci.com/api/v2/pipeline/${pipelineId}/workflow`
const response = await got(url).json()

// returns something like
// {
// "items": [
// {
// "pipeline_id": "5034460f-c7c4-4c43-9457-de07e2029e7b",
// "canceled_by": "026a6d28-c22e-4aab-a8b4-bd7131a8ea35",
// "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
// "name": "build-and-test",
// "project_slug": "gh/CircleCI-Public/api-preview-docs",
// "errored_by": "c6e40f70-a80a-4ccc-af88-8d985a7bc622",
// "tag": "setup",
// "status": "success",
// "started_by": "03987f6a-4c27-4dc1-b6ab-c7e83bb3e713",
// "pipeline_number": "25",
// "created_at": "2019-08-24T14:15:22Z",
// "stopped_at": "2019-08-24T14:15:22Z"
// }
// ],
// "next_page_token": "string"
// }
return response.items
}

const waitForAllWorkflows = async () => {
let workflows

try {
workflows = await getWorkflows()
} catch (e) {
console.error(e)
process.exit(1)
}

workflows.sort((a, b) => {
const dateA = new Date(a.created_at)
const dateB = new Date(b.created_at)

return dateB - dateA
})

workflows = _.uniqBy(workflows, 'name')

_.remove(workflows, (w) => w.name === 'linux-x64') // this is the workflow that is running this job

console.log('workflows', workflows)

const missingWorkflows = WORKFLOW_NAMES.filter((w) => !_.find(workflows, { name: w }))

if (missingWorkflows.length) {
console.error('The following', missingWorkflows.length, 'workflows are required to release and have not been started:\n -', missingWorkflows.join('\n - '))
console.error('Failing early rather than wait for pipelines to finish.')
process.exit(1)
}

// determine workflow states
// https://circleci.com/docs/workflows/#states

// in-progress workflows
const runningWorkflows = _.filter(workflows, (w) => {
return ['running', 'on hold'].includes(w.status)
}).map((w) => w.name)

// failing workflows
const failingWorkflows = _.filter(workflows, { status: 'failing' }).map((w) => w.name)

// failed workflows
const failedWorkflows = _.filter(workflows, (w) => {
return ['failed', 'canceled', 'not run', 'needs setup'].includes(w.status)
}).map((w) => w.name)

if (_.intersection(WORKFLOW_NAMES, failingWorkflows).length) {
console.log('failingWorkflows', failingWorkflows)

console.error('At least one workflow is failing, which has prevented the release from kicking off', failingWorkflows)
process.exit(1)
}

if (_.intersection(WORKFLOW_NAMES, failedWorkflows).length) {
console.log('failedWorkflows', failedWorkflows)

console.error('At least one workflow failed, which has prevented the release from kicking off', failedWorkflows)
process.exit(1)
}

const workflowsToWaitFor = _.intersection(WORKFLOW_NAMES, runningWorkflows)

if (!workflowsToWaitFor.length) {
console.log('All workflows have finished and passed!')

return Promise.resolve()
}

// logging something every time this runs will avoid CI timing out if there is no activity for 10 mins.
console.log(`waiting for ${workflowsToWaitFor.length} workflows to finish:\n - `, workflowsToWaitFor.join('\n - '))

return Promise.reject(new Error('One or more workflows has not finished...'))
}

const main = () => {
verifyCI()

// https://github.com/demmer/bluebird-retry
retry(waitForAllWorkflows.bind(null), {
timeout: minutes(95), // max time for this job
interval: seconds(90), // poll intervals
max_interval: seconds(90),
}).then(() => {
console.log('all done')
}, (err) => {
console.error(err)
process.exit(1)
})
}

// execute main function if called from command line
if (require.main === module) {
main()
}

5 comments on commit 89cc70d

@cypress-bot
Copy link
Contributor

@cypress-bot cypress-bot bot commented on 89cc70d Mar 7, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Circle has built the linux arm64 version of the Test Runner.

Learn more about this pre-release build at https://on.cypress.io/advanced-installation#Install-pre-release-version

Run this command to install the pre-release locally:

npm install https://cdn.cypress.io/beta/npm/12.8.0/linux-arm64/develop-89cc70dad76e32ff7151a84c7ef4a0a9f4bcd500/cypress.tgz

@cypress-bot
Copy link
Contributor

@cypress-bot cypress-bot bot commented on 89cc70d Mar 7, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Circle has built the linux x64 version of the Test Runner.

Learn more about this pre-release build at https://on.cypress.io/advanced-installation#Install-pre-release-version

Run this command to install the pre-release locally:

npm install https://cdn.cypress.io/beta/npm/12.8.0/linux-x64/develop-89cc70dad76e32ff7151a84c7ef4a0a9f4bcd500/cypress.tgz

@cypress-bot
Copy link
Contributor

@cypress-bot cypress-bot bot commented on 89cc70d Mar 7, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Circle has built the darwin x64 version of the Test Runner.

Learn more about this pre-release build at https://on.cypress.io/advanced-installation#Install-pre-release-version

Run this command to install the pre-release locally:

npm install https://cdn.cypress.io/beta/npm/12.8.0/darwin-x64/develop-89cc70dad76e32ff7151a84c7ef4a0a9f4bcd500/cypress.tgz

@cypress-bot
Copy link
Contributor

@cypress-bot cypress-bot bot commented on 89cc70d Mar 7, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Circle has built the darwin arm64 version of the Test Runner.

Learn more about this pre-release build at https://on.cypress.io/advanced-installation#Install-pre-release-version

Run this command to install the pre-release locally:

npm install https://cdn.cypress.io/beta/npm/12.8.0/darwin-arm64/develop-89cc70dad76e32ff7151a84c7ef4a0a9f4bcd500/cypress.tgz

@cypress-bot
Copy link
Contributor

@cypress-bot cypress-bot bot commented on 89cc70d Mar 7, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Circle has built the win32 x64 version of the Test Runner.

Learn more about this pre-release build at https://on.cypress.io/advanced-installation#Install-pre-release-version

Run this command to install the pre-release locally:

npm install https://cdn.cypress.io/beta/npm/12.8.0/win32-x64/develop-89cc70dad76e32ff7151a84c7ef4a0a9f4bcd500/cypress.tgz

Please sign in to comment.