Configure Packet

Overview

To configure Packet for use on Cycle you'll need three things.

  1. An API key
  2. A Project ID
  3. A SSH Key

This guide will show you how to generate each of these assets and use them on the Cycle portal to enable Packet as a provider. If you prefer a video guide you can follow this link.

Generating Packet API Keys

First you need to generate a project scoped API key through the cloud provider Packet.

Log into your Packet account

Don't have a Packet account?
Don't have your Packet account set up yet? Go here to get started with Packet!

After logging into to your Packet account, you should see an option to select your organization. Locate the organization of your target project.

Generate Your Keys

Once you have selected your organization, select your project (ex: My Test Project) from the drop down menu at the top of the screen and then select project settings from the top menu bar.

You can now select API keys from the left menu bar and select ADD to start creating your keys.

The API generation form allows you to add a description to your key and select the permissions associated with your keys.

When you are finished filling out the description and selecting permissions, click the ADD button. Your key should now show up under API keys in Project Settings.

Finding the Project ID

Next you'll need to find the project ID. To find the project ID, make sure you are in "Project Settings" and then look for the "General" tab on the left hand navigation.

Generate Packet SSH Keys

Packet requires you have a project level SSH Key to deploy infrastructure via their API ( which is how Cycle deploys infrastructure through the portal ). The following are the steps you need to generate SSH keys for your Packet infrastructure. It will assume you have followed the API key generation guide above and are familiar with the Packet dashboard.

  • Sign into your Packet Account.
  • Select your project and then project settings.
  • Click SSH Keys from the left navigation.
  • Choose the Add Key button.
  • Name the SSH key "Cycle".
  • Paste in your public pem key and click Add.

If you're not sure how to generate a key that will work follow these steps.

  • Open your terminal.
  • Move into a new directory.
  • Run this command: ssh-keygen -P 'yourpassword' -t rsa -b 4096 -m pem -f my-key-pair.pem
  • Now you'll have a public and private pem key pair.
  • cat out the contents of the public pem key and paste that where I mentioned in the above steps.

Your SSH Key can also be used if, for some reason, Cycle becomes unresponsive and you need to rescue the files on your infrastructure, use your SSH key on port 2160 to log directly onto the Cycle OS.

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!