How to Create and Use Environments.md

How to Create and Use Environments

An environment requires at least one online peer, with resources that match your needs, on which to run. You can rent another user’s peer or you can use your own peer.

The instructions in this guide show you how to create an environment within Subutai Bazaar. Prior to creating an environment, be sure that you are logged in to the Bazaar with your account credentials, and with the PGP key configured in the Account settings. To help manage your keys, you may use the E2E Plugin for your specific browser. For more information about this plugin, see the companion software section at Getting Started.

To create an environment:

1. On the Environment page, click Create Environment.

2. On the Select Peers screen, check the box for the peer that suits your environment, and then click Next.

   💡 Tip | If none of the peers are suitable, click the “Search for other peers” link to select one from the Peers list.

3. On the Select Templates screen, select one from the Templates list on the right side.
   Containers are assigned to templates starting from the top left, in a clockwise direction.

   📝 Note | If you have your own template, upload it to the CDN tool first before you can select it here. For more information, see Subutai CDN. If you are going to install a blueprint on the environment, refer to the Writing Subutai Blueprints article for information about using custom templates.

4. Click the + icon for each container to configure the following properties:

   • Size - Select the size: Tiny, Small, Medium, Huge.
     For information about container sizes, see What is GoodWill.
   • Name - Enter the container name.

5. Click Save to close the container properties, and then click Apply.

6. On the Save Environment popup, enter the name of the environment, and then click Build.
   You can monitor the progress through the status bar at the top of the page.

   When the build reaches the Ready stage, the state changes from Under Modification to Healthy. Congratulations! You have successfully created your environment.

Keep Going!

You can further customize the environment to suit your requirements. If, for example, you want to access the container using a domain name, configure the settings on the Container Port Mapping tab. On this tab, click Add New Port to display the popup where you can select or enter the following details, depending on your setup: Protocol, Port (Internal or External), Domain, Proxy peer, and Containers. Do not forget to save your settings.

The settings for the container and its mapping state are displayed in the table, as shown in the screenshot below.

When you click the domain name link, you will be redirected to the container’s site (Apache, in this example).

What’s Next?

You can to access the environment straight from your desktop, in four steps.

First, be sure to have the Subutai P2P daemon and Control Center installed and set up. These two working together provides access to your environment via SSH or Remote Desktop. To download these applications, go to the Companion software section of Getting Started.

Second, in the Control Center, deploy an SSH key to the environment by accessing SSH-keys management from the menu.

Third, go to Environment from the menu, and then click the environment name to open it.

Fourth, under Remote Access, click SSH to open a terminal and access your container such as in the screenshot below.

For more information about the Control Center and P2P daemon, see How to Use Control Center and P2P.

Feel free to leave your questions or comments in our Slack Community.