Crontab registry

This is example service with one main domain

Index of content

• Project directory structure
• Code standards
• Testing
• Docker
  • Build image
    • Build image for Production
    • Build image for Development
  • Container create
    • Container create for Production
    • Container create for Development
  • Container start
  • Container restart
  • Container destroy
  • Container Stop & Destroy
  • Container run bash
  • Logs for container
  • Set secret on container
  • Full commands
    • Rebuild for development env
  • Environments variables
  • Secrets in project
• How to setup local environment

---

Project directory structure

In this section outlines the project's directory structure and its key components:

• root - Root directory
  • .github - Directory containing configurations and workflows related to GitHub
    • workflows - Directory containing files related to GitHub Actions
  • doc - Directory containing additional documentation (.md files) for the project
  • docker - Directory containing configurations, additional files needed to build the image, and Dockerfile
    • scripts - Directory containing shell scripts required to build the image or run the container (e.g., entrypoint)
  • src - Directory containing the source code for the service or application
  • tests - Directory containing unit and integration tests necessary for verification

Code starndards

This section outlines the code standards followed in the repository, covering topics such as naming rules, naming conventions, and general code conventions. For more in-depth information, please refer to the dedicated document on code standards, accessible here.

Testing

Almost all public methods should be covered by unit tests, and endpoints must be tested by integration tests. All tests related to unit testing should be placed in ./test/Unit, and those related to integration testing should be placed in ./test/Integration. Before creating a Docker image ready to deploy on a specific server, the pipeline should run tests before the building process. This prevents deploying an unstable service or application. You can run unit tests locally via an IDE or manually using the command line:

Run all tests in repository

dotnet test

Run only integration tests

dotnet test ./tests/Integration/Integration.csproj

Run only unit tests

dotnet test ./tests/Integration/Unit.csproj

Docker

This section provides insights into fundamental Docker commands for efficient container management.

Build image

Utilize a Dockerfile to define application configurations and dependencies, creating portable images for seamless deployment across diverse environments.

Build image for Production

docker image build -f ./docker/Dockerfile -t crontab-registry:production .;

Build image for Development

docker image build -f ./docker/Dockerfile.development -t crontab-registry:development .;

Container create

This section details the usage of the docker container create command with specific parameters for creating a container named "crontab-registry."

Container create for Production

docker container create -it -p 18181:4500 --env-file=./.env -l com.salamonrafal.repository="crontab-registry" -l com.salamonrafal.environment="production" --name "crontab-registry" --restart always crontab-registry:production

Container create for Development

docker container create -it -p 18181:4500 --env-file=./.env -l com.salamonrafal.repository="crontab-registry" -l com.salamonrafal.environment="development" --name "crontab-registry" --restart always crontab-registry:development

Container start

This section outlines the usage of the docker container start command, focusing on initiating the "crontab-registry" container.

docker container start crontab-registry

Container restart

This section provides a concise overview of utilizing the docker container restart command, emphasizing the restart action for the "crontab-registry" container.

docker container restart crontab-registry

Container stop

This section provides a brief overview of using the docker container stop command, focusing on halting the "crontab-registry" container.

docker container stop crontab-registry

Container destroy

This section offers a brief overview of using the docker container rm command, focusing on the removal of the "crontab-registry" container.

docker container rm crontab-registry

Container Stop & Destroy

This section provides a concise overview of using the combination of docker container stop and docker container rm commands to halt and remove the "crontab-registry" container.

docker container stop crontab-registry && docker container rm crontab-registry

Container run bash

This section provides a brief overview of using the docker exec command with the options -it to access the interactive shell of the "crontab-registry" container.

docker exec -it crontab-registry bash

Logs for container:

Gain insights into container behavior by leveraging the docker logs command. This tool allows you to retrieve real-time or historical log data, aiding in troubleshooting, debugging, and performance analysis. Understand how to efficiently monitor and interpret the output generated by running containers.

docker logs crontab-registry

Set secret on container

This section provides a brief overview of the command sequence designed to update configuration settings within the "crontab-registry" container using Docker commands.

( source '.env' && docker exec -it crontab-registry \
  dotnet user-secrets set "CrontabRegistryDatabaseOptions:ConnectionString" "${CRONTAB_REGISTRY_MONGODB_CS_SECRETS}" \
  --project ./src/CrontabRegistry/Application/Application.csproj && docker container restart crontab-registry );

This sequence is designed to dynamically update the MongoDB connection string within the "crontab-registry" container, ensuring seamless integration of configuration changes without disrupting the overall application functionality.

Full commands

Rebuild for development env

This section details a command sequence designed to stop and remove the "crontab-registry" container, followed by rebuilding the container with updated configurations.

docker container stop crontab-registry && docker container rm crontab-registry; \
  (source '.env' \
    && docker image build -f ./docker/Dockerfile.development -t crontab-registry:development . \
    && docker container create -it -p 18181:4500 --env-file=./.env -l com.salamonrafal.repository="crontab-registry" -l com.salamonrafal.environment="development" --name "crontab-registry" --restart always crontab-registry:development \
    && docker container start crontab-registry \
  );

This sequence provides a comprehensive approach to update, rebuild, and restart the "crontab-registry" container with the latest configurations.

Environments variables

• DOTENT_APP_CrontabRegistryDatabaseOptions__ConnectionString - You can pass to your application connection string to MongoDb
• ASPNETCORE_ENVIRONMENT - You can set for which environment you deploy code. Options: Development, Production

Secrets in project

Never commit variables such as passwords or other sensitive data to the repository. You can handle such data in several ways:

• Through environment variables (used in this project for deploying the application to a server), and you can read more about them here
• Using user-secrets in dotnet, which is very useful during the development and testing phases. More information can be found here
• By utilizing an application like Vault or a similar tool (the best solution where sensitive data is not stored directly without encryption). You can learn more here

How to setup local environment

This section should describe how to set up your local computer to run the service or application on it.

If you need to test your service without the integration process, you can simply use your IDE or a shell command like:

dotnet run --no-launch-profile --project src/CrontabRegistry/Application/

But before running locally, you have to prepare secrets for access to the database. You can do this in your IDE or use the shell command below:

dotnet user-secrets set "CrontabRegistryDatabaseOptions:ConnectionString" "<CONNECTION_STRING_TO_MONGO_DB>" --project src/CrontabRegistry/Application/Application.csproj

Where <CONNECTION_STRING_TO_MONGO_DB> is a string containing the address and authentication for the MongoDB server, like: mongodb://demouser:demopassword@localhost:27017/