How to Enter a Container in EVE-OS: A Step-by-Step Guide
If you’re working with edge devices in the EVE-OS environment and using the Zededa cloud platform for management, you might need to access a running container to troubleshoot or monitor its activities. This guide will walk you through the process of logging into Zededa, identifying your container, and attaching to it via the console using SSH.
Step 1: Log into ZedControl
The first step is to access ZedControl, Zededa’s cloud-based control platform. You can do this by navigating to ZedCloud in your web browser. Use your login credentials to sign in.
Once logged in, you will have access to your edge nodes, applications, and other resources related to your EVE-OS deployment.
Step 2: Find Your Running Application
After logging in, navigate to the Edge App Instances section. This area shows all the applications currently deployed on your edge nodes. Your goal is to locate the specific application running the container that you wish to access.
• Go to the Applications tab, then Edge App Instances.
• Identify the application that contains the running container by its name or other attributes.
Step 3: Retrieve the Application ID
Once you’ve found your application in zedcloud, you’ll need to get its Application ID, which is required to identify the container on your edge node.
1. Click on the application name to open its details.
2. In the Basic Info section, find the Identity subheading.
3. Look for the ID field, which contains a long alphanumeric string. This is the Application ID you’ll use in later steps.
Step 4: SSH into Your Edge Node
With the Application ID in hand, the next step is to SSH into the edge node running the application. You’ll need the IP address or DNS name of the edge node, along with the appropriate SSH credentials.
1. Open a terminal on your local machine.
2. Use the following SSH command to log into your edge node
ssh root@<edge_node_ip>
Replace user with the appropriate username and <edge_node_ip> with the IP address or hostname of your edge node.
Step 5: List Available App Consoles
Once inside the edge node, you need to find the console associated with the containerized application.
In the SSH terminal, issue the following command:
Replace <path_to_console> with the console path you copied from the output of eve list-app-consoles.
Once you’ve run the command, press Enter.
At this point, you should be inside the container’s console and able to interact with it directly, just like you would in any terminal session.
That’s It!
You’ve now successfully entered a container running on an edge node managed by Zededa’s ZedControl platform. From here, you can troubleshoot, run commands, or monitor the container as needed.
Recap of Steps:
1. Log into zedcloud.
2. Find your running application in the Edge App Instances section.
3. Retrieve the Application ID by navigating to the app’s Basic Info section.
4. SSH into your edge node using its IP address or hostname.
5. List the available app consoles using eve list-app-consoles and match the Application ID to the console path.
6. Attach to the container console using eve attach-app-console and the copied path.
That’s all you need to access your container running on EVE-OS! Now, you can interact with the container directly, making it easier to debug your edge applications.
Kris Clark | Solutions Architect | Tech Enthusiast | DIY Builder