Marketplace
OctaSpace Ecosystem: OctaSpace...
Custom docker images
6 min
the octaspace marketplace provides the flexibility to run any containerized application from public or private registries this enables you to deploy specialized tools and custom built environments that may not be available in the pre configured application catalog in this guide, we will demonstrate how to deploy a custom docker image from docker hub , using visual studio code as an example step 1 locate your image on docker hub before deploying, you must identify the correct image and tag from docker hub for this example, we will use the popular kasmweb/vs code image, which provides a vs code interface accessible via a web browser search for the image on docker hub note the image name kasmweb/vs code check the tags tab for a specific version (e g , latest) or a specific architecture step 2 configure the marketplace session once you have identified your image, navigate to the https //marketplace octa space/ to begin the deployment access compute rental upon loading the marketplace, you will typically land on the apps section if the sidebar menu is collapsed, open it and select the compute rental option select a node browse the node list and select a provider that meets your hardware requirements (cpu, ram, and disk) open configuration click the configure button on your chosen node deployment configuration on the configuration page, you will define the parameters for your custom container image name input the full image path and tag for this example, we use kasmweb/vs code 1 18 0 rolling daily port mapping if the container requires a web ui or specific internal ports (such as port 3000 for kasm vs code), enter the port number if multiple ports are required, use a comma to separate them (e g , 3000, 8443) environment variables if the image utilizes specific variables for configuration (like password or sudo password), click the "add environment variable" button consecutively for each required entry once all fields are populated, click deploy to launch your session the network will pull the image from the registry and initialize the container on the provider's hardware monitoring deployment status deploying a custom image involves several stages you can track the progress and diagnose any startup issues directly from your sessions dashboard 1\ the pulling state once you click deploy , the node must first download the image from the container registry (e g , docker hub) status the initial state will show "pull {image name}" meaning this indicates the node is currently downloading the image layers the time this takes depends on the image size and the node's internet speed 2\ monitoring session logs to see exactly what is happening inside the container during the startup process, you can view the real time logs open details click on the active session row to open the session details pop up access logs click the clipboard icon (located next to the node details) to monitor progress view output a separate window will appear select the container logs tab to view the live output from your docker image monitoring these logs is the best way to troubleshoot common issues, such as missing environment variables or port conflicts 3\ service configured & ui access once the image is fully downloaded and the container has successfully initialized its internal services, the status will update status "service configured" accessing the ui click on the session again in the details pop up, look for the http services section if you mapped a port correctly (e g , port 6901 for vs code), you will be presented with a direct link to your application's web interface wait for the app sometimes the status shows "service configured" while the application inside the container is still finishing its internal setup if the link doesn't load immediately, check the logs again to ensure the process is complete