Create a new container

To develop, test or debug your app, you want to create a Business Central container. You can easily achieve that from within Visual Studio Code by following these steps:

  1. In the Visual Studio Code extension right click on the Containers node under the Repository of your app and choose Create container.
  2. Enter a name for your new container.
  3. Wait until the container was created and is shown in the list. If someone else already used a similar container, this just takes a few seconds. Else this might take up to 20 minutes the first time.
  4. After your container was created, the color of the icon shows the status of the container. The red icon indicates that the container is starting. As soon as the icon turns blue, the container is ready to access it.
  5. You will now want to create a configuration in your launch.json or open the Web Client, terminal, file share, log, configuration or statistics in the browser.

Select a specific BC artifact configuration when creating a new container

If you have multiple BC artifact configurations set up in your cosmo.json file, you might want to create a container using one of those configurations other than the default, which is "current". You can do so fo by following these steps:

  1. In the Visual Studio Code extension right click on the Containers node under the Repository of your app and choose Create container with artifact selection
  2. Enter a name for your new container.
  3. Wait until the container was created and is shown in the list. If someone else already used a similar container, this just takes a few seconds. Else this might take up to 20 minutes the first time.
  4. After your container was created, the color of the icon shows the status of the container. The red icon indicates that the container is starting. As soon as the icon turns blue, the container is ready to access it.

Select arbitrary BC artifact version and country when creating a new container

If you want to quickly create a container for a specific version and country without adding a new configuratoin to your cosmo.json you can do so by following these steps:

  1. In the Visual Studio Code extension right click on the Containers node under the Repository of your app and choose Create container with version & country selection
  2. Enter a name for your new container.
  3. Enter the version for your new container. The default version from the "current" configuration is pre-filled.
  4. Enter the country for your new container. The default country from the "current" configuration is pre-filled.
  5. Wait until the container was created and is shown in the list. If someone else already used a similar container, this just takes a few seconds. Else this might take up to 20 minutes the first time.
  6. After your container was created, the color of the icon shows the status of the container. The red icon indicates that the container is starting. As soon as the icon turns blue, the container is ready to access it.