Add GitHub Actions workflow for automated iOS release to CocoaPods #73

arkaza-nr · 2025-12-08T08:24:33Z

Adds automated release workflows for iOS Video Agent SDK using semantic-release and GitHub Actions.

Changes:

Automated version bumping: Creates release PRs automatically based on conventional commits
Automated publishing: Publishes to CocoaPods when release PRs are merged
CHANGELOG generation: Auto-generates changelog from commit history

Testing

Tested on user/arkazakumari/ios-release-automation branch with git push.
Release Workflow Run: https://github.com/newrelic/video-agent-iOS/actions/runs/20316223199/job/58360440802

Release PR: #86

NOTE:
The ios-publish.yml workflow could not be fully tested on the user/arkazakumari/ios-release-automation branch due to a GitHub Actions limitation:

GitHub only recognizes and triggers workflows that exist on the default branch (master).

The ios-release.yml workflow was testable because it triggers on push events, which registered it with GitHub when we pushed to the test branch
The ios-publish.yml workflow triggers on pull_request: closed events, but GitHub never registered it because workflows on non-default branches are not automatically discovered by GitHub. Even with the workflow file present and PRs being merged with the release label, GitHub couldn't execute it.

Once merged to master, the workflow will be automatically registered by GitHub and will trigger on future release PR merges.

ametku · 2025-12-08T12:41:13Z

@arkaza-nr
New commits cannot be commit to master since it's a protected. Ideally, you need to create a PR with the changes. You can refer to videojs release or discuss with Divya

ametku · 2025-12-08T12:45:37Z

@arkaza-nr Currently, it's expected that new release is created manually. Can you refer to VideoJs release and include it so that when a branch is merged to master. There is a release done automatically.

ametku · 2025-12-08T12:42:11Z

.github/workflows/ios-release.yml

+
+jobs:
+  release:
+    runs-on: macos-latest


is there any specific release for macos-latest ?

There's no need for macOS here. "ios-release.yml" workflow only does git operations and Node.js tasks. Changed to ubuntu-latest for faster execution and lower cost. The "ios-publish.yml" workflow still uses macos-latest since it needs CocoaPods.

ametku · 2025-12-08T12:48:42Z

.github/workflows/ios-release.yml

+          echo ""
+
+          VERSION="${{ steps.get_version.outputs.version }}"
+          MAX_ATTEMPTS=20


If it fails to go through within 20 tries. Is there a way we can re run workflow and expect this to pick up. What I mean is - is this workflow idempotent ?

Yes, we can re-run the workflow and it will safely pick up where it left off. No duplicate tags or releases will be created. Pod publish will fail if already published, but this is safe and expected.

ametku · 2025-12-08T12:50:01Z

RELEASE.md

+
+## Testing the Workflow (Without Publishing)
+
+You can safely test the workflow on non-master branches:


This is not needed in release.md

ametku · 2025-12-09T11:56:46Z

@arkaza-nr please confirm, Currently we are needed to add assets to release. Check this. Check if this can be done too. This is a manual step atm.

## [4.1.0](4.0.1...4.1.0) (2025-12-15) ### Features * add automated release workflow ([77845b8](77845b8)) * add automated release workflow ([ff3cdd6](ff3cdd6)) * add automated release workflow ([46eacd1](46eacd1)) * add automated release workflow ([9eab955](9eab955)) ### Bug Fixes * add conventional-changelog-conventionalcommits dependency ([3809333](3809333)) * correct YAML syntax for PR body and commit message ([82cb673](82cb673))

github-actions · 2025-12-15T11:12:36Z

🎉 This PR is included in version 4.1.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

…:newrelic/video-agent-iOS into user/arkazakumari/ios-release-automation

[skip ci]

chore(release): 4.1.0

…:newrelic/video-agent-iOS into user/arkazakumari/ios-release-automation

[skip ci]

chore(release): 4.1.0

ametku · 2025-12-18T05:32:05Z

RELEASE.md

+6. Creates a git tag (`vX.Y.Z`)
+7. Creates a GitHub Release with installation instructions
+8. Verifies all pods are published
+9. Deletes the release branch (cleanup)


This step is unwanted since it always better to leave a trail in automation so that dev can review back in the future.

done, removed branch clean up step.

ametku · 2025-12-18T05:33:18Z

RELEASE.md

+git commit -m "chore: update dependencies"
+```
+
+## Release Process (Step by Step)


"Workflows" and "Release Process (Step by Step)" are duplicating content. We could just keep "Release Process (Step by Step)"

ametku · 2025-12-18T05:35:29Z

RELEASE.md

+- Creates git tag `vX.Y.Z`
+- Creates GitHub Release


creating GitHub Release should create git tag automatically. If these 2 steps are seperate then only GitHub Release can be present

Yes, we aren't creating tag manually. It's created through GitHub Release only. Updated RELEASE.md file with the same.

ametku · 2025-12-18T05:37:14Z

RELEASE.md

+### Branch Protection
+
+Recommended branch protection rules for `master`:
+
+- Require pull request reviews
+- Require status checks to pass
+- Require branches to be up to date
+- Do not allow bypassing the above settings
+


this section seems not required

Removed this section.

ametku · 2025-12-18T05:38:12Z

RELEASE.md

+
+---
+
+Last updated: December 2025


this is not required since it's version controlled

ametku · 2025-12-18T05:39:09Z

RELEASE.md

+4. **Automatic Cleanup**
+   - Release branches are deleted after successful publish
+   - Keeps repository clean
+   - Clear lifecycle from creation to deletion


this is not needed in my opinion

removed branch cleanup step.

ametku · 2025-12-18T05:39:58Z

RELEASE.md

+
+### Key Principles:
+
+1. **One Branch = One PR**


please add preferably it's develop in normal development workflow

added notes for normal development workflow.

[skip ci]

## [4.1.0](v4.0.1...v4.1.0) (2025-12-23) ### Features * add automated release workflow ([77845b8](77845b8)) * add automated release workflow ([ff3cdd6](ff3cdd6)) * add automated release workflow ([46eacd1](46eacd1)) * add automated release workflow ([9eab955](9eab955)) * automate iOS release process with semantic versioning ([2b846de](2b846de)) * implement stable one-shot PR release workflow ([7f711db](7f711db)) * test release workflow ([4dc66b7](4dc66b7)) * test release workflow after tag cleanup ([01993c1](01993c1)) * test stable one-shot PR workflow ([903711c](903711c)) * tetsing publish workflow ([021c894](021c894)) * trigger release workflow ([f89705c](f89705c)) ### Bug Fixes * add conventional-changelog-conventionalcommits dependency ([3809333](3809333)) * add label to release PR ([03c6932](03c6932)) * add label to release PR ([8cfb755](8cfb755)) * changelog not generated in dry run mode ([4de8065](4de8065)) * correct YAML syntax for PR body and commit message ([fb8fb14](fb8fb14)) * correct YAML syntax for PR body and commit message ([82cb673](82cb673)) * remove tag craetion through semantic release ([9769857](9769857)) * remove unnecessary manual tag creation step ([56e88c0](56e88c0)) * semantic tag creation ([ad9679d](ad9679d)) * tag creation should happen during release creation ([2486db0](2486db0)) * tag creation with semantic ([29ee1ae](29ee1ae))

Add iOS release automation workflow

7e2bdba

arkaza-nr requested review from ametku and avinash-newrelic December 8, 2025 08:24

ametku requested changes Dec 8, 2025

View reviewed changes

arkaza-nr and others added 8 commits December 15, 2025 15:39

chore: semantic-release setup

131b077

feat: add automated release workflow

9eab955

feat: add automated release workflow

46eacd1

feat: add automated release workflow

ff3cdd6

feat: add automated release workflow

77845b8

fix: add conventional-changelog-conventionalcommits dependency

3809333

fix: correct YAML syntax for PR body and commit message

82cb673

arkaza-nr added 11 commits December 16, 2025 12:10

fix: correct YAML syntax for PR body and commit message

fb8fb14

chore: allow test branch for semantic-release testing

c1f07ec

chore: release branch should only have mandatory files

ef6dce5

chore: can have changed files in test branch

25a0d2d

feat: automate iOS release process with semantic versioning

2b846de

chore: code clean up

8aa76d2

feat: implement stable one-shot PR release workflow

7f711db

feat: test stable one-shot PR workflow

903711c

fix: remove unnecessary manual tag creation step

56e88c0

feat: test release workflow

4dc66b7

feat: test release workflow after tag cleanup

01993c1

arkaza-nr force-pushed the user/arkazakumari/ios-release-automation branch 3 times, most recently from a79fd2f to 01993c1 Compare December 17, 2025 18:32

arkaza-nr and others added 12 commits December 18, 2025 01:20

fix: add label to release PR

8cfb755

Merge branch 'user/arkazakumari/ios-release-automation' of github.com…

eb97b87

…:newrelic/video-agent-iOS into user/arkazakumari/ios-release-automation

fix: add label to release PR

03c6932

chore(release): update podspec versions to 4.1.0

d3698d7

[skip ci]

Merge pull request #84 from newrelic/release/4.1.0

4952ec2

chore(release): 4.1.0

chore: testing workflows

ffc3d2f

Merge branch 'user/arkazakumari/ios-release-automation' of github.com…

40f4b15

…:newrelic/video-agent-iOS into user/arkazakumari/ios-release-automation

chore: testing workflows

b65c39c

chore(release): update podspec versions to 4.1.0

bd8e4b7

[skip ci]

Merge pull request #85 from newrelic/release/4.1.0

a0d5cd1

chore(release): 4.1.0

chore: testing workflows

fdd4c20

chore: remove debugging code

1934455

ametku requested changes Dec 18, 2025

View reviewed changes

arkaza-nr and others added 17 commits December 18, 2025 13:39

chore: addressed comments

9747a25

fix: tag creation should happen during release creation

2486db0

fix: semantic tag creation

ad9679d

fix: remove tag craetion through semantic release

9769857

fix: tag creation with semantic

29ee1ae

fix: changelog not generated in dry run mode

4de8065

chore(release): update podspec versions to 4.1.0

fb73e36

[skip ci]

fix: version was getting updated in local branch

6f6de8b

fix: version was getting updated in local branch

9f30241

fix: use conventional-changelog for tag creation

4e8b121

fix: use conventional-changelog for tag creation

815f28f

fix: add conventional-changelog-angular dependency

75bf6bc

fix: add conventional-changelog dependency

9238f19

fix: version is incorrect in chnagelog

7a2b6d0

fix: extract changelog in release notes, remove debugging code

015c019

chore: add assets to release note

88d3343


		## Testing the Workflow (Without Publishing)

		You can safely test the workflow on non-master branches:


		---

		Last updated: December 2025 No newline at end of file

Add GitHub Actions workflow for automated iOS release to CocoaPods #73

Are you sure you want to change the base?

Add GitHub Actions workflow for automated iOS release to CocoaPods #73

Uh oh!

Conversation

arkaza-nr commented Dec 8, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ametku commented Dec 8, 2025

Uh oh!

ametku commented Dec 8, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ametku commented Dec 9, 2025

Uh oh!

github-actions bot commented Dec 15, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

arkaza-nr commented Dec 8, 2025 •

edited

Loading