Creating App Runner services

You can create an App Runner service in AWS Toolkit for JetBrains by using the Create App Runner Service dialog box. You can use its interface to select a source repository and configure the service instance where your application runs.

Before creating an App Runner service, make sure that you completed all the prerequisites. Included is providing the relevant IAM permissions and taking note of the specific information about the source repository that you want to deploy.

To create an App Runner service

1. Open AWS Explorer, if it isn't already open.

2. Right-click the App Runner node and choose Create Service.

   The Create App Runner Service dialog box is displayed.

3. Enter your unique Service name.

4. Choose your source type (ECR, ECR public or Source code repository) and configure the relevant settings:

   ECR/ECR public

   If you're using a private registry, choose the Deployment type:

   • Manual: Use manual deployment if you want to explicitly initiate each deployment to your service.

   • Automatic: Use automatic deployment if you want implement continuous integration and deployment (CI/CD) behavior for your service. If you choose this option, it means that whenever you push a new image version to your image repository or a new commit to your code repository, App Runner automatically deploys it to your service without further action required from you.

   For Container image URI, enter the URI of the image repository that you copied from your Amazon ECR private registry or Amazon ECR Public Gallery.

   For Start Command, enter the command to start the service process.

   For Port, enter the IP port that's used by the service.

   If you're using an Amazon ECR private registry, select the required ECR access role and choose Create.

   • The Create IAM Role dialog box displays the Name, Managed Policies, and Trust Relationships for the IAM role. Choose Create.

   Source code repository

   Choose the Deployment type:

   • Manual: Use manual deployment if you want to explicitly initiate each deployment to your service.

   • Automatic: Use automatic deployment if you want implement continuous integration and deployment (CI/CD) behavior for your service. If you choose this option, it means that whenever you push a new image version to your image repository, or a new commit to your code repository, App Runner automatically deploys it to your service without further action required from you.

   For Connections, select a connection that's available from the list on GitHub connections page.

   For Repository URL, enter the link to remote repository that's hosted on GitHub.

   For Branch, indicate which Git branch of your source code that you want to deploy.

   For Configuration, specify how you want to specify your runtime configuration:

   • Configure all settings here: Choose this option if you want to specify the following settings for the runtime environment of your application:

     • Runtime: Choose Python 3 or Nodejs 12.

     • Port: Enter the IP port that your service uses.

     • Build command: Enter the command to build your application in the runtime environment of your service instance.

     • Start command: Enter the command to start your application in the runtime environment of your service instance.

   • Provide a configuration file settings here: Choose this option to use the settings that are defined by the apprunner.yaml configuration file. This file is in the root directory of your application’s repository.

5. Specify values to define the runtime configuration of the App Runner service instance:

   • CPU: The number of CPU units that are reserved for each instance of your App Runner service (Default: 1 vCPU).

   • Memory: The amount of memory that's reserved for each instance of your App Runner service (Default: 2 GB)

   • Environmental variables: Optional environment variables that you use to customize behavior in your service instance. Create environmental variables by defining a key and a value.

6. Choose Create

   When your service is being created, its status changes from Operation in progress to Running.

7. After your service starts running, right-click it and choose Copy Service URL.

8. To access your deployed application, paste the copied URL into the address bar of your web browser.