keptn Keptn Tutorials, 15 Apr 2021

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Tutorial - Keptn in a box

Description

Follow the tutorial yourself here: https://tutorials.keptn.sh/tutorials/keptn-in-a-box-08/index.html

Get the source: https://github.com/keptn-sandbox/keptn-in-a-box

What you'll find in this video:
00:00 Intro
01:15 Installation
12:34 What has been installed + Demo
24:00 Troubleshooting
26:42 Try it yourself

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
Join our Keptn community newsletter: https://keptn.sh/community/newsletter/

A

Hi and welcome everyone to this video on the tutorial captain in the box. uh Today, I'm really excited to have searcher here, hi sasha. How are you doing today.

B

Hi jurgen I'm doing fine thanks for having me.

A

Really glad to have you here, I'm really excited to see what you have built with captain in the box. It's a let's say a one. One line installation of captain plus um example, projects plus standard choice, integration, everything is running on one vm. You don't need to bring your own kubernetes cluster. Everything is provided by your tutorial captain in the box, so I will give you your screen a little bit more real estate here and I'm really excited to see what you have built and how you can use it. So the stage is all yours.

B

Thank you, jurgen exactly so kept in the box is basically a patch script right that uh will enable you to start your journey to the autonomous cloud, really really easy right. So if you go to tutorials at captain sh here, you will see the tutorial and this tutorial.

A

Is basically just.

B

The explanation right or what the script does and we're gonna do this together right. So um before I start explaining, let's just save some time and be efficient, so I have already an ubuntu machine prepared and I'm gonna just kick off the installation right. So in here I have captain.

A

B

And I have here already how to start it and I'm gonna send the script. So now I kicked off the installation all right um and I'm gonna explain what what is the script doing um so we use the time efficiently so kept that in a box just pass script for this. Let me just actually use a slide that I prepared for you and.

A

By the way, the link to the tutorial is in the video description below uh so everything that we are going to see here from searcher. You can follow on your own machine or in the cloud by just following the tutorials. Exactly.

B

A

Here are also the.

B

Links of the project where you find all the source files and of the tutorial which link you to the source files right. So this is just a bash script that is programmed in a modular fashion, meaning you can select what you need. If you have um wanna do a workshop in your company or with your friends or do a code session, you can uh select only what you need right depending the more you need. The bigger the machine is gonna have to be right. Why?

B

Because you're gonna having a single machine, you can they're gonna install we're gonna install docker, so you can have your own registry. You can push your own images, uh we're gonna use microkubernetes. The latest version: zero. Eight one we're using 119 ubernet is 119, which is right. Now the most common production version is going to install cube ctl. So you can, if you log to the machine, you start typing qctl and it's already bound to the two microkubernetes they're going to have the latest east 201 1.9 helm, jenkins.

B

Gaitea is your own git server, so you can see because captain uses github's approach. So you can see all the repositories that is using captain for your projects right, so you can analyze the shifter file, the sli, the slo configuration and all that which enables you to learn faster. It's going to have your own repository.

B

um I don't think we have a tutorial for building own images. But if you have your own image you can you don't need another repository. You can use the single machine and push the the your own images and you can use helm charts and have your own contained devops environment right. So we're going to use an engine next ingress, meaning you don't need a a a load balancer ip right, just using the symbol, ip of the machine.

B

This can be the local uh interface or, if you have a public id, which is better we're going to expose everything with the magic domain with nepali right and if you have a dyna trace. I recommend you to try it with anatress, go to dynatris trial and you can get the installation with the full stack agent and kubernetes monitoring, meaning you're gonna, get monitoring of kubernetes and the namespaces events, and all that right.

B

In a more technical way, this is actually I can explain this at the end right, but this is basically what captain box is. So, let's just go into the tutorial right.

B

First, you're gonna need your ubuntu box right. um What we test is 18 and 20 uh the versions. The long term support here here are some links that you can create a cloud account, so you can have a free tier. If you don't want to have a cloud instance, you can also use multi-pass. Multi-Pass is a project of ubuntu that allows you to have locally virtual machines in ubuntu. The sizing depends highly on how much components you want to install right.

B

So what I just literally just did right now uh I was already inside an ubuntu machine. I download the shell file right and I made it executable so inside the shell file. You have a couple of configurations that you can have you don't have to. You can just run it the way it is, but I modify a little bit. What did I modify? I entered the dimetris api token and the past open here. You can see how you can get the steps, so you can get your token.

B

I didn't configure the um the domain, because the machine by default is the domain variable is empty, is gonna, make a call to it. Config me, meaning if you have a public ip, it's gonna expose all the services with the public id using nitpio, which is a magic domain, meaning it's going to resolve always to the idea you're, giving that it allows you to have with sub-domains all the services that you want right. The cards, the captain kubernetes api, kubernetes dashboard, whatever you deploy in there, you can use with only one ip right, for example.

B

In this example, you can see we're exposing a machine in a home wi-fi right, so you have the option to create a workshop user where you can specify the user and password which allows you to create machines for your colleagues and say: hey jurgen. This is your machine with your user. You can and the password you're going to want to try right which will uh configure it.

B

So you can access it via ssh and when you're gonna access, this machine he's gonna, be able to use cube, ctl, captain cli and everything that we're installing in there right. So everything is already configured, so he can just get in there and start typing and deploying applications right. So the installation bundle um captain is programming a modular way. So these are like the modules or control flags which are defined in each module so urine, meaning if docker install equals true we're going to install docker if micro ubernet is equals.

B

True we're going to install it right and the bundle is a set of configurations right. So you you can configure it as you want. You can say: okay, I do want to have this or you can enhance it. If you modify the function, shell file, you can add more modules or more stuff that you can configure right and uh yeah.

A

B

Pretty much, that's it right now. What I did I modified the shell script with bundle all because I want to show all the modules deployed in a machine right. I'm gonna need a bigger I'm using a 2x large, if I believe in aws, so I can have enough power to have absurd manager, gaitia, dinotrus, monitoring, captain with the execution plane and the control claim kubernetes api.

B

By the way you have. You need to be careful also, if you want to patch the coordinated dashboard, which means we're modifying the kubernetes dashboard that is exposed, so you can access it without credentials right. So it's really easy for you to start learning uber needs. But you need to be aware that if we touch it, it's accessible to everyone right, so you can also start uh uh killing pots or deploying stuff that you don't really want right, um yeah and the same with the captain bridge we disable the login.

B

uh Actually I see I need to put a flag in here also um for you to learn faster right, so you don't have to type the the the the user password. So you can access captain bridge easily right and.

A

B

So before I started the explanation.

A

This is what run just one um one comment uh from my side here, so the best is to just use a installation bundle not to go through all the different options and flags, but to select one installation bundle. So in this case we use the uh the full uh all the installation funnel all we want to have everything, but all the bundles are described just a little bit below uh sorry um um over this this table.

A

So on top of this table, we have all the installation, bundles and it's best to just choose one bundle and then do the installation.

B

By the variable, exactly by.

A

B

In step number 12, I have advanced features where I show how to uh after you have installed captain in a box how you can restore it like delete everything so that okay, I broke it. How can you reinstall it again or how can you install specific features right because you can load the shell file and run the functions separately right so um yeah, and for that I'm gonna explain a little bit later. Let's just take a look, how the installation is going, but yeah you're going to write.

B

So you see here the different bundles, so you can say okay in demo. What is in the bundle demo and you can see what functions are in there, where is in the workshop captain, only meaning without execution, plane right or only the quality gates?

B

So it's really up to you.

B

So, let's just see how is the installation going? We see it's running on the background. This is a way for you to be efficient. You can always, if you do less plus f the install log, you can see the actual status right. So it's a process that you're sending in the background. You can do your stuff uh in the machine and then take a look at it, because sometimes it takes a bit of time, especially updating ubuntu.

B

A

B

Here it's updating, ubuntu.

B

It's still terrible, okay, not a problem. We can take a look on another machine which we prefer a bit before. So let's take a look at this one.

A

So I know that it sometimes it takes up to 10 minutes for the the whole package to be installed. I already did it a couple of times myself in and uh searcher already prepared for us for this video uh kind of another machine where we can skip the installation procedure, it's running in the background of the other machine, but just for the demo purpose.

A

We are now switching to the machine that we just created uh actually um like one hour ago um for us to to be able to skip this part and the waiting part um exactly. We.

B

A

See it here, it took seven minutes only seven.

B

Everyone took seven minutes and 24 seconds right and we um at the very bottom at the end of the installation, um we print the credentials. So you can take a look and also the usage how much space you're you're using the dis available right so at the very beginning, also the flags are going to be there. So if you have any any issue, you can always talk to us and say hey. I have an issue and with the log file we can see exactly which step and what what the configuration to trigger.

B

So we know if something went wrong. Also, you need to be aware if you have a public ip or some credentials in there, that you're putting don't just don't upload it to to slack just let us know, and you can send us a private email. So we can uh so your credentials are not exposed right.

B

So um at the very bottom you see, for example, here all the services. These are ingresses right, the ingresses that are exposed and we have captain. We have kaitia. We have a home page right, jenkins, api kubernetes, the cards application on english right. We have the credentials for unleash because there is a tutorial, the captain full tour, so actually we're deploying the full tour automatically right. So let me just show you really really quick what I mean.

B

So, if I get out of this tutorial here, is the captain full tour on trace, so the script is actually going all the way to step 26. I believe no. This is also done so uh before the load generation right.

B

So the the the the workshop or the d deploys all the way to step 26 without the this load generation right.

A

So you can just.

B

Run the experiment and do this: you only need to do one step right.

B

So, let's just go back step number 10 we're showing how to access the services.

A

B

So here are all the services, something you need to know is uh if I type qctl now it's not going to show me. This is letting me know, hey you don't have enough information. Why? Because um this is gonna, be installed. I mean in the same session that I am. I don't have the permission, so I need to create another session. I can exit the machine and get inside the machine or create a new new shop right. So.

B

So I'm logging as ubuntu okay, now qct will get all now. I have all the services you see, so don't.

A

B

If, after the installation, you have the same shell and you try- you try to type keep ctl, it's not gonna work the same with captain I can now I can type captain and now it's authenticated right and I say captain version and it's showing me the version right, because now it's already authenticated with the server, so everything is already there for you the same as docker, I can't have docker and I can start already building my my images and pushing them to captain or to the registry or all that.

A

Right, can we try to do it? A captain get project so just see if there are already some projects. Yes,.

A

Oh here we go really cool.

A

Exactly I know that you also have a kind of a home page that will list everything that is installed. So maybe we can take a look at this home page because that will be the starting point once you have installed uh captain box, the home page is, is your starting point with all the links and it's always the landing.

B

Page exactly so what I did just now, I type cube ctl get ingress all so I have all the ingress of the namespaces of all the namespaces. I'm sorry- and I want to copy this- the homepage ingress, because this will be the starting point right for the captain in the box. So let's just put this and there we have it right. This is the machine we have here some links and these links are done with javascript, so, depending on the domain, you're gonna adapt automatically right. So I have the kubernetes dashboard exposed right.

B

So I can click here on skip and boom. I have already all the parts, all the name spaces, so I can start learning, also kubernetes, I'm new to learning this right to understand. Okay, what is our demonstration? What is a deployment? What kind of jobs stuff like that? So we have the kubernetes api also exposed right. So you can start communicating with the api. If you have, you can manage different machines and you use modify the keep the config file, so you can also do remotely stuff.

B

The captain is also exposed, so the captain bridge, as you see I don't- have credential, because this is a workshop machine. So in here I.

A

B

Two projects we have stock shop and english. I said before this is coupled with the tutorial the the full tour right. So if I go into the sub shop, I have developing staging production and I can see it's already uh done. The three stages right. It.

A

Looks good yeah, so we do have two services, the cards and the the image both of them are already deployed and delivered. There was a quality gates executed in staging.

B

So really cool and the dslrs, and everything is here configured right, so you can go into the services right, so um also nice to know is that these services are exposed, so you can actually interact with the services in here. There's a link called delivery pipeline overview. So if I click in here, it's nothing else that an html with iframes.

B

So we have cards in development in staging and in production right. So we have the three different stages right and uh you can also access each one of them singular like development, and you can see this is the url with our magic domain right.

A

Really cool, and can we also take a look on the git repository because I think uh there is also everything uh connected to the.

B

Repository exactly so, git is deployed with the subdomain git right. So if you click on the link, maybe I click too fast here on the repositories. It has an api, so you can manage repository with the api and it has also a ui. So in the ui we see the sock shop and unleash so if I click on the sock shop, captain uses branches for the stages right, so we have here the master. Then we have production staging and the effort right.

B

So if I go, for example to them, I'm going to see the resources and the services that we have on board right. The cards and the cards tv and the files inside the yaml files, the geometer file, with the basis check and the helm chart right.

B

A

Really good yeah! So sorry, I just want to highlight here that you see everything has been created just a couple of minutes ago. So this is the fresh installation that sanchez started just before we started the recording to have kind of a backup machine to save some time in this recording and everything was created. So when you execute the captain in the box bash script that we showed in the beginning of this video, this is what you will get out of the box. There was no manual intervention needed.

A

This is what you already get and you can start playing and start learning um with with captain. That's the really cool part you don't have to follow the tutorial. You can still follow the tutorial, the full tour on dynatrace, and it will give you all the steps and every step has been already executed automatically in this captain in the box, and this is why I really love it because it's so fast to spin up and show it to someone and experiment with captain and to learn captain that's right exactly.

B

Exactly and let's say, for example now you want to because everything is in the machine so uh well first, now that I'm in git, I can sign in here and the credentials are again, we put them on the uh on the shell file right.

B

B

So in here, for example, you see the workshop user we created, so I can actually access with ssh with this user and password that you can modify um and as well. The git server access here is the username and the password. So you can manually create more projects and on board and stuff like that, the same, uh there is also a jenkins server for another session, where we can show how easy it is to expand and enhance pipelines right uh the credentials for unleash and yeah on this services.

B

uh What I wanted to show as well is in here you can see that the repository was cloned, so we have the examples repository of the captain tutorials and we have the captain in a box also repository that was cloned, because in here there are some function that allows you. For example, if I go to resources and I go to demo right, they're gonna.

A

B

Deploy card 0 1, because that can actually even be automated. Let's say we want to deploy cards number two, there's nothing else! That's just calling the captain trigger delivery right, so I can actually just hold this file or manually, and now I'm sending version two, that's it as it's just that I already onboarded one and it went through all the stages right. So if I go to the machine right- and this is the pipeline in here version, two is gonna.

B

Come right: let's take a look at the bridge and we should see that we have a new event there. It is already coming in three years already right. So let me just make this a bit bigger yeah.

B

A

B

You to start your journey and do the tutorials.

A

Cool, uh I think it's really a great tutorial, uh the captain in the box. uh You can get started so fast with.

B

This integration.

A

uh We've seen how you can get started, how to install it, what it will uh give you uh how to configure it. There are different installation bundles. uh There is even a troubleshooting guide that sergio mentioned um if something goes wrong, but actually I already did it a couple of times now we even used it for workshops already and it always worked like a chart. So it's a really great thing um to um to use and to give it a try um thanks also for putting here the the slack for captain.

A

So if you have any questions, please find us in the captain slack. Yes, I think this was a great episode to show our community uh how to use captain and how to get started really fast with captain in the box. That already brings you all the demo experience that we're providing in the other tutorials.

B

Exactly um how much do I have two minutes sure explain perfect so guys if you face an issue again reach us on slack, we're more than glad to help you. uh There are some scripts here that allows you to see hey. Do I have a problem or not so doing like this, helps you to find do I have an error in the lot right. Also, if you're learning, then the best way is to deploy stuff and break stuff.

B

So if you break the machine, not a problem, you could here have some functions, so you can restart microkubernetes, delete, microkubernetes and start all over again. For that we recommend doing a snap remove. So you purge everything and you start over again right, and there are some advanced features in bash means load the functions in in the shell right. So when you load the functions in the shell, then you can start um calling them manually right.

B

So in here we're calling installation bundle all for example, or if you want to let's say you want to deploy jenkins, to call source function and installation bundle, all meaning, you're low. Putting sorry this means we're setting all the control flux to true right, because.

A

B

A function inside this function is like, if jenkins equals true, do it right, so we're loading function and setting everything to true. So now we can call functions. I mean here where it can deploy jenkins manually or uh enable kubernetes dashboard or the own git server right or create a work. Another workshop account a worship account or another meaning. You want to use the machine and add more users. This script is going to create a home directory and load captain and qctl, so you can have multiple users right and that's it.

A

Cool, so I see there is much more than what we've showed in this video. um Maybe.

B

A

Can do a follow-up video on this, but I would really encourage everyone to give it a try.

A

Tutorials.Captain.Sh, you will find everything and afterwards, when you experimented with captain in the box- and you learned how to use captain, then you can just go to captain.sh fetch the cli and install it on the full kubernetes cluster to maybe use captain in your organizations or for your projects.

A

So thanks searcher for joining today. It was really a pleasure to have you here and to learn how captain in the box works and how to use it and uh yeah happy captaining and shipping applications.

B

Thank you jurgen for having me. Thank you guys.

A

B

And a lot of learning bye.

A