keptn Keptn Tutorials, 7 Apr 2022

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Triggering sequences from the Bridge UI

Description

In this short video, Elizabeth Lang and Rob Jahn introduce the new trigger feature that was released with Keptn 0.14.1. It allows you to trigger sequences directly from the Bridge/CLI.

Find all the details of the new release here: https://keptn.sh/docs/news/release_announcements/keptn-0141/

-------------------------------------------------------------------------
Learn more: https://keptn.sh
Get started with tutorials: https://tutorials.keptn.sh
Join us in Slack: https://slack.keptn.sh
Star us on Github: https://github.com/keptn/keptn
Follow us on Twitter: https://twitter.com/keptnProject
Sign up to our newsletter: https://bit.ly/KeptnNews

A

Hi captain users- this is rob, jan one of the uh ambassadors for the project and I'm really excited about captain 0.14 and to show uh one of the new features that we've been waiting for around triggering sequences and for that I'm going to turn over a demo to elizabeth lang, who's one of the ux developers on the captain's side. Elizabeth all to you.

B

um You can already trigger sequences from the cli, but the idea was to make it a bit more user friendly and to have the whole feature in the bridge also.

B

So, basically, what what we wanted to build is a form that takes in all the values that you also can give to the cli and then just yeah conveniently start a sequence from the bridge.

B

Yeah, a user story, as you can see, is basically what is the goal of the story, and I added a lot of stuff in here, because I also did the mock-up for um the story. So maybe we can also take a look at that, so um this is basically.

A

What what what tool are you using elizabeth to build these mock-ups.

B

So I use figma, which is really great for doing stuff like that, so you can do wireframes with it and what I will show you now is you can also link screens and create fully clickable prototypes more or less so this is not implemented. Yet this is just a mockup and I can also already interact with it. So this is what it is based on um and yeah. I wrote all the special considerations for developers already also in this story, so that it doesn't get lost because in the mock-up you cannot tell everything.

A

B

Remember I remember you did a couple.

A

Mock-Ups too, because uh you know during the uh you know the development you said: here's option, one here's option two and he got some feedback and I found that that mock-up was really helpful just to right. You could interact with it, even though it wasn't executing something, but you get a sense of the different look and feels yeah there. You go right variant. One variant, two perfect.

B

Yeah exactly so, I what I tried is basically more or less a really small user study, because I was not entirely sure if we should um include it like. um I already showed you here, so the idea was either to include it in the direct link to the page. I think this is also the same here. Yeah exactly and the second.

B

um The second option was to have it in like a pop-up, um so I will show you if it looks yeah so.

B

Yeah and I was not entirely sure what was the better option. So I did this short poll in um yeah just in this issue and I think the results were.

A

Yeah there you go yeah, so everyone liked the the in page. So that's that's a great yeah, immediate feedback. uh Yeah! That's great! I love that yeah. I think I was one of the people that liked the I liked I liked the inline as well, so it was one of those 10. I think I remember right.

A

That's great! Okay,.

B

Yeah, I think um yeah. This is a lot.

A

Of fun, it also came in from.

B

A

I was like I put.

A

B

And we will definitely consider some of these, but uh yeah we had to build this base feature first and yeah if you want. I can already show it to you, because I have this now on my local installation, so it's more or less 4 0 14 and a bit more because I have it in my master branch, but anyways feature still stays the same.

B

So as you can see in the environment screen there is this trigger new sequence button, as you already saw in mockups, and also if you go to sequences it's here. So if I click here, you're rerouted to the environment page again and there you have now the option to trigger new sequence, you can either trigger deliverance sequence and evaluation sequence or a custom sequence.

B

I I will explain what other custom sequences later when I get to the demo for it.

B

So deliverant evaluation is more or less the same as you used from the cli. So what you have to do is to select the service. You want to trigger delivery, for example, for cards, and you can also select the stage. So if you want to trigger this delivery for the whole pipeline, just select the first stage.

B

So if I put this in and click on next, I have now the option or the option. I have to define the image and attack and I can optionally define which labels go in for display purge process and also values that are used for the helm chart.

B

So this is the pass to hit the helm service and the values are process bait. So I will just do it with oops.

A

Right, so those form fields are specific to the delivery sequence. That's a built-in sequence of captain correct, so so.

B

In other words,.

A

Image and tag is not required for triggering every sequence correct it's just this.

B

For the delivery, it's necessary yes, yeah um and for the other so.

A

Yeah you'll, probably demo those ones but yeah. So that's that's where right now, I think that's where it's flexible right, because you had, if you have an evaluation which maybe you'll show that requires different parameters where this one has things like the image and the tag that are required.

B

A

Very great yeah.

B

I'll just put in this our cards example the tag I want to deploy. I can also use 33 and just for them purposes, because I usually don't use it. um I just added label here that we can see that it's also added to the to the sequence then so I cannot trigger it and you're re directed directly to the sequencer screen, the sequence already started and as you can see, the label is also here and it will run through as usual. So this is a really. This is a basic delivery sequence.

A

Perfect yeah, I love it yeah and I see the I see I get my button again on that page.

B

So if you want to trigger, for example, so let's go and.

A

B

A

B

So I can do this also for the services I have defined in my environment and also for every stage. So let's go and do it for staging. For example, um four time frames I have the option to use a time frame or to use the start and then time so here um for the evaluation for the time frame. If you don't put anything in into the fields, it will just um take default values, so I described it here. um If I put not anything in, you will evaluate five minutes from now.

B

So this is also what is just done by the cli more or less.

B

You can also use a started end time, but here you have to put something because otherwise would be very weird and yeah. You can just select it like I wanted from today at 12 and and uh today at so, I think yeah.

A

Yeah, let's take charging.

B

A

Because, normally you would have to put this right in the command line request or in a json file and send it as a send event.

B

A

These sequences so yeah this is I'm really excited about this, because it's it's just more natural to want to you know, be able to run it in a you know, on demand from a user interface, so yeah.

B

A

B

I think it's a great improvement for for captain. um What you can see here now is that it's utc timestamp, but there is already a ticket for improvement to show a bit more of a human readable date. So this will definitely come. That's.

A

I'm always I'm always having to uh translate yeah. I forget, I think it's epoch time, there's a website where I always go to and have to uh figure that out and then I and now I've saved a unix command like automatically build that for me so yeah. So I would agree that would be helpful.

B

Yeah, it's always a bit confusing because I'm in in was central europe time, and it's always one hour minus.

A

Exactly and then this time zone so, like I know, you're in a time zone, I'm not in a time zone. I wasn't a time zone change, no we're not, but hey it's. If you didn't hear america is now almost about to pass a united states bill to eliminate the daylight savings time. So hopefully that's great, hopefully that'll one country down, hopefully all right anyway.

B

Yeah we're waiting we're waiting for them in europe too, but let's see, if that happens, all right.

A

Maybe they'll follow up so so you can follow our lead and then maybe america can follow the lead of having the metric system right. So yeah.

B

I wish we had the metric system, like you guys.

A

It's so much easier. I still can't do ounces to pounds and all that all right. So, let's fire the sequence.

B

Yeah I'll just trigger it, uh we can also take a look at the evolution part. I should, I think it should be in here and yeah as you can see. Starting and date is defined as.

A

B

A

Right and if people don't know the time frame, the right elizabeth said it defaults to five minutes, but you can do things like you know an hour, correct elizabeth, that there are little shorthand ways you can do 10 minutes. So that's a very that's also a convenient thing because it's just you know for me the last five minutes or the last hour or days.

B

Yeah, putting just five or.

A

B

So that the minimum is one minute so you have so if you have like 50 seconds, it will tell you that it's not valid.

A

B

But otherwise um yeah, you can also put one hundred dollars in if you want so.

A

Yeah I mean something yeah exactly I mean, depending on what you're evaluating it makes sense.

B

Yeah exactly just to.

A

Look at something like that, especially maybe like yeah so perfect. Okay,.

B

I just put in 150 and we started now because I wanted to know it right.

A

People that are watching it's not it doesn't take an hour to run it. What it's doing is it's looking either for your time frame or looking for from now backwards an hour. You know. So it's it's so it does. You have to wait an hour. It's gonna, just it's really defining the time frame in two different modes. Right.

B

Yep, okay, I see it fail. Okay, we maybe have to look at it because it's my my um information from core was that we can put it anything but yeah.

A

That's really, why we're it's? Not it's not production yet, so this is.

B

No, it's not projecting it so.

A

This is good that we found that all right, so third, one custom.

B

Custom, so if you maybe know the tutorials from for captain, there is, for example, this delivery direct sequence which you can trigger. um You can, for example, so for cards.

B

You can let's stay here for protection and yeah, then you can select all sequences that are defined in the shipyard file that are not delivered evaluation, so I can also trigger, for example, row back or a remediation if necessary. I just I don't know if, if I have it correctly configured to be honest in my environment but which you can just try, because otherwise the sequence they will fail anyways. So if the configuration is not no, I get.

A

It yeah, that's fine. No, I think that's that's good for people. You know this is where we're starting to show people. um You know, especially in a different topic around web hooks and things like that, so people typically define their own custom sequences um and that's just the term. We call it so if it's not one of the built-in sequence types like an evaluation or delivery, then it's it could be whatever.

A

As elizabeth said in your in your shipyard file, you can actually define one-to-many individual sequence files and that drop-down will show up sounds like automatically by parsing your shipyard file, um similar to the the web hook page where you can here. You can see the the tasks as well on this on the web hook page but yeah there you go so you've rolled uh ran the roll back.

B

Production, for example, yeah. So I would also ask anyone that uses the custom sequences if you find anything that is especially here is missing, that you need some additional fields or something that would be very helpful feedback for us to improve this. So.

A

Yeah I mean I, I mean one thing that I've done um again because I build it in the json file. I can actually specify um the first task attributes. So if my first task was deployment I can put in there, you know like the deployment pre-fill in the deployment attributes and then that will get passed on so that maybe if there was a free form field, for you know specifying a little json to be passed in to me. You know to be added in that might be an idea.

B

A

Yeah but yeah so overall, this is great so this so this is coming out in in uh captain 14, correct.

B

Yes should be so, I don't know the exact date. It should be released in the next few weeks.

A

Yep, that's great, so if people watching the video be sure to watch the general channel of captain slack, this is usually where I watch it. So you can see they make announcements, hey it's it's available and uh this will be one of the features and there's a and maybe show uh sorry to put you on the spot so where, when, when releases like this come out, there's a r is there a release? Notes area? um Is that also, I think that's on the captain on the captain.

A

So might as well we'll show.

B

People that, if you haven't found this.

A

Yeah so yeah, so on the main repo, it's captain captain and then right, each um each each release comes out with, with a little header section there, yeah.

B

The releases on the right side and for everyone we have the release, notes, for example, for this one: it's just they were just bug fixes, but for the major releases, let's scroll down a bit yeah there we have it. um Our new uh is also described new features and announcements. So.

A

B

You can stay informed, what's yeah, it's also. I.

A

Usually read them because sometimes I'm not always on the recent one, so it's nice to read, you know and then see all the links. So that's how I think I found elizabeth is, as I saw the the issue that I was interested in and I I I realized that she was the developer contributing code, and so this was great, so elizabeth. Thank you so much for the demo. I think people will be very, uh very excited to use it and try it and give you feedback. So thank you, yeah for all your hard work, you're.

B