Debugging apps with SSH

Get SSH access to your app

This API requires at least auterion-app-api: 2 to be available

Directly accessing your app via SSH can be beneficial, especially for debugging. When deploying apps on Skynode, the internal IPv4 address of specific docker containers will be determined at runtime. To improve the quality of live of developers, AuterionOS can automatically create dynamic SSH routes for apps such that the IPv4 address of the underlying docker containers does not need to be known.

Enabling direct SSH access

1. Enable SSH port forwarding

In the auterion-app.yml file, enable SSH port forwarding by adding ssh: true

...auterion-app.yml...
services:
    <my-service-name>:
        build: <location of Dockerfile>
        ssh: true

2. Make sure you have openssh-server installed in your app

Make sure your app image contains openssh-server . If you are using the auterion/app-base:v2 base image, you already have openssh-server

3. Create an SSH keypair

Create an SSH key-pair to use to access your app. You can do this from the command line

ssh-keygen -t ed25519 -f my-app-key

4. Insert public key in your app and start sshd

In your Dockerfile add your public key to the authorized keys. The public key can be found in my-app-key.pub.

RUN echo "ssh-ed25519 ....." >> /root/.ssh/authorized_keys

Change the command in your Dockerfile to make sure to launch the SSH Daemon (SSHD) with your app like so

CMD /usr/sbin/sshd && ./my-app

5. Access app

Now build and install the app. You can then use auterion-cli app list to locate the SSH port that was assigned to the app.

Open an SSH connection to your app by explicitely specifying the port to be used:

ssh -i my-app-key -p <port from auterion-cli app list> root@10.41.1.1