Networks Overview

Quickly create and manage an isolated private network connecting up to 5 environments. Networking your environments together enables many different complex application deployment paradigms.

Container Communication

  • Network Identifier - The identifier to be used when communicating over the network.
  • Network Name - The name of the network.

When communicating with containers in the same environment, they can access each other by hostname. If the hostname for the container you were trying to reach was db you could run ping db and it would resolve. Communicating over a network is different.

Cycle creates a new network interface completely separate of the other networks available to your container. Communicating between containers on the network is fully isolated from both the environment and public networks. That means if you want to communicate with other containers over the network you'll have to add additional network information to the hostname of the container your trying to reach. This way Cycle knows you want to use the network when looking for the container hostname.

If the network identifier is "bar" an the container hostname is "foo", the container foo can be accessed over the network bar by pinging foo.bar.

Create a Network

To create a network:

  • Select to the Networks tab from the left side navigation and click Create Network.
  • Fill in a name and select which cluster you would like to make this network available on.
  • Start adding environments you would like to apply this network to.

You can select as many or as few environments to apply the network to as you wish (minimum 2). Don't worry if you decided you want to add or remove an environment you can change that by updating your network.

Update a Network

  • Add or remove an environment from your Network.
  • Change the name of your network

Navigate to the network dashboard by clicking Networks on the left side menu. Then click on the network you wish to update. From here you can change the name field by changing the name field. Add or remove (or both) networks by selecting new networks from the menu or clicking the x.

Once you have made your changes, click Update Network.

Delete a Network

Once you delete a network it cannot be reversed so be sure you wish to do this before moving forward.

  • Navigate to the network dashboard.
  • Click the network you wish to delete.
  • Enter the name of the network in the delete network form.
  • Hold down the Delete Network button.

Need Help?

If you've got questions about the platform or need some help getting started, our team is more than happy to assist. Whether you're new to containers or just new to Cycle, reach out to us via livechat by clicking the blue circle in the bottom right corner. Join our Slack channel, and get help from the dev team or other members of the community, and check out our Roadmap to see what's planned for the future!