aws-scheduler-targets-alpha: Add StepFunctionsStartExecution

[WtfJoke]

Describe the feature

Currently the only impelmentation of IScheduleTarget is LambdaInvoke.

It would be great if we could have also StepFunctionsStartExecution as one of the templated apis in the aws console.

Use Case

You can have a lot of targets in event scheduler, but in this alpha module its only possible to trigger a lambda. I would like to be able to trigger a Step Function/State Machine from there.

Proposed Solution

The implementation can be very similar/almost identical like LambdaInvoke.

I've tested following implementation in a private project succesfully (heavily inspired by the existing LambdaInvoke code):

export class StepFunctionsStartExecution
  extends ScheduleTargetBase
  implements IScheduleTarget
{
  constructor(
    private readonly stateMachine: IStateMachine,
    private readonly props: ScheduleTargetBaseProps,
  ) {
    super(props, stateMachine.stateMachineArn);
  }

  protected addTargetActionToRole(schedule: ISchedule, role: IRole): void {
    const stateMachineEnv = this.stateMachine.env;
    if (!sameEnvDimension(stateMachineEnv.region, schedule.env.region)) {
      throw new Error(`Cannot assign stateMachine in region ${this.stateMachine.env.region} to the schedule ${Names.nodeUniqueId(schedule.node)} in region ${schedule.env.region}. Both the schedule and the stateMachine must be in the same region.`);
    }

    if (!sameEnvDimension(stateMachineEnv.account, schedule.env.account)) {
      throw new Error(`Cannot assign stateMachine in account ${this.stateMachine.env.account} to the schedule ${Names.nodeUniqueId(schedule.node)} in account ${schedule.env.region}. Both the schedule and the stateMachine must be in the same account.`);
    }

    if (this.props.role && !sameEnvDimension(this.props.role.env.account, stateMachineEnv.account)) {
        throw new Error(`Cannot grant permission to execution role in account ${this.props.role.env.account} to invoke target ${Names.nodeUniqueId(this.stateMachine.node)} in account ${this.stateMachine.env.account}. Both the target and the execution role must be in the same account.`);
      }

    this.stateMachine.grantStartExecution(role);
  }
}

Other Information

I would like to contribute this feature during the hacktoberfest.
It would be great if this repository can be marked with the topic "hacktoberfest" so that it gets counted towards the goal (see https://hacktoberfest.com/participation/#maintainers for more info) :)

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

CDK version used

2.99.1

Environment details (OS name and version, etc.)

windows, wsl

[scanlonp]

Hey @WtfJoke, this looks like a great feature to add! We did add hacktoberfest to the topic of this repository this morning, and once you open a PR, we can assign the correct label so it counts for you!

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.