When configuring network settings in containerized services, always document the reasoning behind specific choices, especially for port mappings and security-related flags. This helps other developers understand the configuration and prevents accidental misconfigurations.
For port mappings, use reasonable external port numbers and explain any non-standard choices:
ports:
- 9432:5432 # Postgres port - using 9432 to avoid conflicts
For network security flags, document their purpose and security implications:
healthcheck:
test: ['CMD', '/opt/mssql-tools18/bin/sqlcmd', '-C', '-Usa', '-PPr1sm4_Pr1sm4', '-Q', 'select 1']
# -C flag trusts server certificate without validation
This practice prevents confusion during deployment and helps maintain consistent network configuration across environments.
Enter the URL of a public GitHub repository