learning-path.md

copyright	lastupdated	keywords	subcollection
years 2022	2022-05-05	learning paths, code engine, deployments, tools, applications, jobs, project, log, monitor	codeengine

{{site.data.keyword.attribute-definition-list}}

Learning paths for {{site.data.keyword.codeengineshort}}

{: #learning-paths}

Find your path to accomplish what you want with {{site.data.keyword.codeenginefull}}. {: shortdesc}

Plan your deployments

{: #lp-plan-deployments}

Before you start, learn about {{site.data.keyword.codeengineshort}} and some common terms.

Then, decide whether you want to deploy an application or create a job by reading planning for {{site.data.keyword.codeengineshort}}.

You can even try out our application tutorial or our job tutorial.

Install the tools

{: #lp-install-tools}

If you plan to use the CLI, you must install it. As you work with your {{site.data.keyword.codeengineshort}} workloads, refer to the CLI command reference and track of CLI version updates with the CLI change log.

If you do not want to use the CLI, you can work from the console{: external}.

Create your first project

{: #lp-set-environment}

To get started with {{site.data.keyword.codeengineshort}}, create a project to contain your entities. You can also set access policies for your project.

Need help? Check out troubleshooting tips for projects. If you need more help, try getting support.

Develop your application or job

{: #lp-develop-app-job}

{{site.data.keyword.codeengineshort}} deploys applications and runs jobs that are bundled into container images. If you do not have a container image, you can build and deploy your code from within {{site.data.keyword.codeengineshort}}.

Do you have source code or a container image for your application or job?

I have a container image. Where is your image stored?

• If your image is stored in a container registry that you have access to, then you are ready to deploy.
• If your image is in a private registry, either in a different {{site.data.keyword.registryshort}} account or in private registry such as Docker Hub, you must set up access.

Then, you are ready to deploy your application or run your job.

I have source code. How do I get started?

• Find out what advantages are available when you build your image with {{site.data.keyword.codeengineshort}}.
• Plan for your build.
• You can also find tips for creating a Dockerfile.
• If your source code is in a private repository, set up access.
• Optionally, set up an {{site.data.keyword.registrylong_notm}} namespace to hold your built image. If the {{site.data.keyword.registryshort}} namespace is in a different account, set up access. If you do not set up access to your {{site.data.keyword.registrylong_notm}} namespace, access is created automatically for you.
• Build your source code.

Need help? Check out troubleshooting tips for builds. If you need more help, try getting support.

Deploy your application

{: #lp-deploy-app}

To get started, read plan a container image for {{site.data.keyword.codeengineshort}} applications.

How does your application scale? See Configuring application scaling.

Want to customize your application?

• Does your application require a project endpoint? See Deploying your app with a project endpoint.
• Does your application require a private endpoint? See Deploying your app with a private endpoint.
• How much CPU and memory does your application need? See Supported memory and CPU combinations.
• Do you have commands and arguments to add to your application? See Deploying your app with commands and arguments.
• Want to define environment variables for your application? Find out how with Working with environment variables.
• Does your application take advantage of configmaps or secrets? Take a look at Setting up and using secrets and configmaps.

Ready to deploy?

• Deploy application workloads from a public repository.
• Deploy application workloads from images in {{site.data.keyword.registryshort}}.
• Deploy application workloads from images in a private repository.

To make your application highly available or to use a custom domain name, see Deploying an application across multiple regions with a custom domain name.

Want to add more customizations?

• Want to integrate with other {{site.data.keyword.cloud_notm}} services? See Integrating {{site.data.keyword.cloud_notm}} services with service binding.
• Want to connect an event producer to your application? See Subscribing to event producers.

Ready to access your application?

• Access the application.
• You can also assign a custom URL. See Deploying an application across multiple regions with a custom domain name.

Each update of an application configuration property creates a new revision of the application.

• Find information to update your app.

You can use Iter8 to validate your application code and latency and then determine if your revision is ready to use or if you must roll back to a more stable version.

Need help? Check out troubleshooting tips for applications. If you need more help, try getting support.

Run your job

{: #lp-run-job}

To get started, read plan a container image for {{site.data.keyword.codeengineshort}} jobs.

Do you want to create a job definition?

By creating a job definition, you can more easily run your job multiple times based on your configuration.

• Create a job from a public repository.
• Create a job from images in {{site.data.keyword.registryshort}}.
• Create a job from images in a private repository.

Do you want to run a job without first creating a definition?

With the CLI, you can submit a job run without first creating a job configuration. You can specify the same configuration options on the jobrun submit and jobrun resubmit commands that are available with the job create command.

• Run a job with the CLI without first creating a job configuration.

Want to customize your job?

• How much CPU and memory does your job need? See Supported memory and CPU combinations.
• Do you have commands and arguments to add to your job? See Deploying your application with commands and arguments.
• Want to define environment variables for your job? Find out how with Working with environment variables.
• Does your job take advantage of configmaps or secrets? Take a look at Setting up and using secrets and configmaps.

{{site.data.keyword.codeengineshort}} supports Lithops for running jobs. See running jobs with Lithops framework.

Ready to create and run your job?

You can run your job directly or create a job definition and run your job based on that configuration.

• To run a job directly, see Run a job with the CLI without first creating a job configuration.
• To run a job from a job definition, see run a job.

Want to add more customizations?

• Want to integrate with other {{site.data.keyword.cloud_notm}} services? See Integrating {{site.data.keyword.cloud_notm}} services with service binding.
• Want to connect an event producer to your job? See Subscribing to event producers.

Need help? Check out troubleshooting tips for jobs. If you need more help, try getting support.

Log and monitor your workloads

{: #lp-log-mon}

Logging can help you troubleshoot your applications and jobs. See Viewing logs.

You can also view, manage, and audit user-initiated activities that occur in your {{site.data.keyword.codeengineshort}} project.

Finally, analyze performance metrics by collecting information with {{site.data.keyword.mon_full_notm}}. You can create custom dashboards to monitor {{site.data.keyword.codeengineshort}} workloads.