DeployStack DeployStack Logo DeployStack

Render: Contributing to Render Service Types

This guide explains how to contribute to the Render.com service type configurations in docker-to-iac. The service types configuration determines whether a Docker service should be deployed as a web service, private service, or Redis service on Render.com.

Configuration Location

The service types configuration is stored in:

src/config/render/service-types.ts

This configuration is specific to Render.com and is not used by other cloud provider parsers.

TypeScript Configuration Structure

The configuration uses the following structure:

interface ServiceTypeConfig {
  type: string;
  description: string;
  versions: string;
}

interface RenderServiceTypesConfig {
  serviceTypes: {
    [key: string]: ServiceTypeConfig;
  };
}

export const renderServiceTypesConfig: RenderServiceTypesConfig = {
  serviceTypes: {
    'docker.io/library/mariadb': {
      type: 'pserv',
      description: 'MariaDB database service - requires private service type due to TCP protocol',
      versions: '*'
    }
  }
};

Field Definitions

  • serviceTypes: Root object containing all service type mappings
  • Image key (e.g., docker.io/library/mariadb): The fully qualified Docker image name
    Should match the normalized format from getImageUrl utility
    For official Docker Hub images, use docker.io/library/[name]
    For user repositories, use docker.io/[user]/[repo]
    For GHCR, use ghcr.io/[owner]/[repo]
  • type: The Render service type
    pserv for private services (databases, message queues, etc.)
    web is the default and doesn't need to be specified
  • description: A clear explanation of why this service type is needed
  • versions: Version matching pattern
    Use "*" for all versions
    Future: Will support semantic version ranges

Contributing Guidelines

web

Example Addition

Here's an example of a good service type addition:

export const renderServiceTypesConfig: RenderServiceTypesConfig = {
  serviceTypes: {
    // Existing configurations...
    'docker.io/library/postgresql': {
      type: 'pserv',
      description: 'PostgreSQL database service - requires private networking for security',
      versions: '*'
    },
    'docker.io/library/rabbitmq': {
      type: 'pserv',
      description: 'RabbitMQ message broker - requires private TCP communication',
      versions: '*'
    }
  }
};

Service Type Categories

Private Services (pserv)

Common services that should use pserv:

  • Databases (MySQL, PostgreSQL, MongoDB)
  • Message queues (RabbitMQ, Apache Kafka)
  • Cache services (except Redis)
  • Backend services that don't serve HTTP traffic

Web Services (web)

Services that should remain as default web type:

  • HTTP APIs
  • Web applications
  • Frontend services
  • Application servers

Getting Help

If you're unsure about:

  • Which service type to use
  • How to format the image name
  • Whether a service needs a specific type

Please:

Edit on GitHub