Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

  • Yaml not yml

  • Scripts:

    • bash scripts should always have a shebang and be named <script>.sh

    • Use comments at the top to fill out the following details:
      ```
      #!/bin/bash
      # Author:
      # Date Created:
      # Date Last Modified:
      # Description:
      # Usage:
      ```

  • Verbose environment names so development instead of dev or production instead of prod

  • In Terraform use “_” not “-“

  • Make workflows generalized, less workflows the better.

    • As such make workflow names generalized for your use case. `cicd` is a perfectly fine name when compared to `clean-ephemeral-environment`.  You will know what to expect or at least the desired outcome when opening the workflow details in `cicd`.

  • Commands and jobs in CI/CD:

    • Descriptive and concise will win for these names

    • lean towards reusability and agnostic names instead of making a job `deploy-production` name the job `deploy` with an environment parameter.

  • logging:

    • Always use kebab-case

  • Azure names:

    • Needs more investigation

  • Databases:

    • Must be uniquely named within our organization

    • Names should follow this format:

      • `<app-name>-<environment suffix>-<dbtype>`

      • redis, pgsql, are the preferred dbtype names 

      • example: `dst-development-redis`

  • Services:

    • services name should be indicative of both the process and it’s role in the process. For example - the bare word `invite` is not specific enough. We can delineate between an api service, vs. a schedule, vs a job worker. `invite_worker` is more appropriate in this example

  • Apps:

    • apps have to be unique from the organizational scope. They are not unique to an environment. An app name should follow this pattern:

      • `<application name>-<environment-suffix>

  • Stacks:

    • if a stack is built with shared infrastructure, the name should start with `shared-`. 

    • stacks built in dedicated infrastructure must omit that prefix

  • Environments

    • must be unique to the organization

  • No labels

0 Comments

You are not logged in. Any changes you make will be marked as anonymous. You may want to Log In if you already have an account.