# Edge Linux Development
Edge software only runs on Linux environments. This article will combine various steps already documemented in ADP to create a Linux development environment suitable for creating custom versions of Edge Tutorials or for new Edge Development. This configuration is meant for an Azure based enviroments, either a Virtual Machine or an Azure Hyper-V Virtual Machine, running on a VNET peered with your Ablility Instance.
WARNING
If the network is not VNET peered with an Ability Instance, you will not be able to upload types for the edge nodes you create. You can still create those types, but you will have to move them to an enviroment that can access the Instance API TDR endpoints to upload them.
# Before You Begin
This procedure is vaild for any Ubuntu 18.04 installation. Most of the individual steps to setup this machine are already documented. This document puts them all together.
INFO
Ubuntu 20.04 is still under testing for these intructions. Instructions will be updated once the same flow is confirmed working.
Here is an overview of the process:
- Install Ubuntu Server
- Promote Ubuntu Server to Desktop. See NOTE.
- Install Development Software. This includes .NET, Visual Studio Code, Chrome and supporting software.
- Install Docker
- Test Instance API
- Test Custom Build of one of the Tutorial projects.
NOTE
Ubuntu Server -> Promote to Ubuntu Desktop path is documented to handle Ubuntu VMs
created by the Azure Markeplace. Azure only install the server version of Ubuntu.
It is not practical to use Visual Studio Code on a server install. By using this
process, RDP is enabled by default and the steps are same for Ubuntu server if
installed on any hardware, virtual or bare metal.
# Create Develpoment Environment.
If you already have an Ubuntu Server available, login with you favorite SSH client. If one is not available, select suitable hardware or virtual environment, install Ubuntu and login.
Promote Server to Desktop. Follow all the steps to verify that RDP works. RDP allows copy/paste from one RDP session to another and this can speed up develpment.
Install .NET and Development Tools. Follow the instructions to verify that Google Chrome and Visual Studio Code are working correctly.
Install Docker. Remember to reboot for the install user to be recognized as a member of the docker group.
Confirm that VNET Peering is completed. Use this procedure to build the InstanceApp Tool and this procedure to test access to your Instance. If you don't have a solution available, review the process to request a solution.
Once you have access to the Instance APIs for your solution, you can now select one of the Tutorials and create a custom versions of them. The InstallApp can upload the new type and an Edge can be configured to run that type.
# Next Steps
With this environment setup, Edge and Install API develoment can proceed.