1.14.0 • Published 1 month ago

@nestjs-mod/docker-compose v1.14.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 month ago

@nestjs-mod/docker-compose

Docker Compose is a tool for defining and running multi-container applications. It is the key to unlocking a streamlined and efficient development and deployment experience. (Generator docker-compose.yml for https://docs.docker.com/compose)

NPM version monthly downloads Telegram bot

Installation

npm i --save @nestjs-mod/docker-compose

Modules

LinkCategoryDescription
DockerComposeinfrastructureDocker Compose is a tool for defining and running multi-container applications. It is the key to unlocking a streamlined and efficient development and deployment experience. (Generator docker-compose.yml for https://docs.docker.com/compose)
DockerComposeAuthorizerinfrastructureAuthorizer is an open-source authentication and authorization solution for your applications. Bring your database and have complete control over the user information. You can self-host authorizer instances and connect to supported databases. (Generator for https://authorizer.dev in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)
DockerComposeMinioinfrastructureMinIO is a high-performance, S3 compatible object storage. (Generator for minio in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)
DockerComposeNatsinfrastructureNATS is an open source, lightweight and high-performance messaging system. It is ideal for distributed systems and supports modern cloud architectures and pub-sub, request-reply and queuing models. (Generator for nats in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)
DockerComposeNginxinfrastructureNginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. (Generator for nginx in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)
DockerComposePostgreSQLinfrastructurePostgreSQL (Postgres) is an open source object-relational database known for reliability and data integrity. ACID-compliant, it supports foreign keys, joins, views, triggers and stored procedures. (Generator for databases in docker-compose.yml for https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/libs/infrastructure/docker-compose)
DockerComposeRedisinfrastructureThe open-source, in-memory data store used by millions of developers as a cache, vector database, document database, streaming engine, and message broker. (Generator for redis in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Modules descriptions

DockerCompose

Docker Compose is a tool for defining and running multi-container applications. It is the key to unlocking a streamlined and efficient development and deployment experience. (Generator docker-compose.yml for https://docs.docker.com/compose)

Use in NestJS-mod

An example you can see the full example here https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-prisma-flyway or https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-prisma.

import { PACKAGE_JSON_FILE, ProjectUtils, bootstrapNestApplication } from '@nestjs-mod/common';
import { DOCKER_COMPOSE_FILE, DockerCompose } from '@nestjs-mod/docker-compose';
import { join } from 'path';

export const flywayPrismaFeatureName = 'flyway-prisma';

const rootFolder = join(__dirname, '..', '..', '..');
const appFolder = join(rootFolder, 'apps', 'example-prisma-flyway');

bootstrapNestApplication({
  modules: {
    system: [
      ProjectUtils.forRoot({
        staticConfiguration: {
          applicationPackageJsonFile: join(
            appFolder
            PACKAGE_JSON_FILE
          ),
          packageJsonFile: join(rootFolder, PACKAGE_JSON_FILE),
          envFile: join(rootFolder, '.env'),
        },
      }),
    ],
    infrastructure: [
      DockerCompose.forRoot({
        configuration: {
          dockerComposeFileVersion: '3',
          dockerComposeFile: join(appFolder, DOCKER_COMPOSE_FILE),
        },
      }),
    ],
  },
});

After connecting the module to the application and npm run build and starting generation of documentation through npm run docs:infrastructure, you will have new files and scripts to run.

New scripts mostly package.json

{
  "scripts": {
    "_____docker-compose infra_____": "_____docker-compose infra_____",
    "docker-compose:start:example-prisma-flyway": "export COMPOSE_INTERACTIVE_NO_CLI=1 && docker-compose -f ./apps/example-prisma-flyway/docker-compose.yml --compatibility up -d",
    "docker-compose:stop:example-prisma-flyway": "export COMPOSE_INTERACTIVE_NO_CLI=1 && docker-compose -f ./apps/example-prisma-flyway/docker-compose.yml down"
  },
  "scriptsComments": {
    "docker-compose:start:example-prisma-flyway": [
      "Running the docker-compose infrastructure for example-prisma-flyway"
    ],
    "docker-compose:stop:example-prisma-flyway": [
      "Stopping the docker-compose infrastructure for example-prisma-flyway"
    ]
  }
}

Empty docker-compose file for application docker-compose.yml with real credenionals and add it to .gitignore file

# Do not modify this file, it is generated using the DockerCompose module included with NestJS-mod.
version: '3'

Empty docker-compose file for application docker-compose-example.yml with fake credenionals

# Do not modify this file, it is generated using the DockerCompose module included with NestJS-mod.
version: '3'

Shared providers

ManualDockerComposeFeatures

Configuration

KeyDescriptionConstraintsDefaultValue
dockerComposeFileMain file for docker-compose, the Compose specification establishes a standard for the definition of multi-container platform-agnostic applications.isNotEmpty (dockerComposeFile should not be empty)--
prodDockerComposeFileMain file for prod docker-compose, the Compose specification establishes a standard for the definition of multi-container platform-agnostic applications.optional--
exampleDockerComposeFileExample file for docker-compose, the Compose specification establishes a standard for the definition of multi-container platform-agnostic applications.optional--
prodDockerComposeEnvFileDotenv file for prod docker-compose file.optional--
dockerComposeFileVersionDocker-compose file version. @see https://docs.docker.com/compose/compose-file/compose-versioningisNotEmpty (dockerComposeFileVersion should not be empty)3-
beforeSaveExampleDockerComposeFileBefore save file for example docker-compose.optional--
beforeSaveDockerComposeFileBefore save main file for docker-compose.optional--
beforeSaveProdDockerComposeFileBefore save main file for prod docker-compose.optional--
beforeSaveDockerComposeEnvFileMethod before save dotenv file for docker-compose file.optional--
beforeSaveProdDockerComposeEnvFileMethod before save dotenv file for prod docker-compose file.optional--

Feature configuration

KeyDescriptionConstraintsDefaultValue
versionThe top-level version property is defined by the Compose Specification for backward compatibility. It is only informative. @see https://github.com/compose-spec/compose-spec/blob/master/04-version-and-name.mdoptional--
servicesA service is an abstract definition of a computing resource within an application which can be scaled or replaced independently from other components. @see https://github.com/compose-spec/compose-spec/blob/master/05-services.mdoptional--
networksNetworks are the layer that allow services to communicate with each other. @see https://github.com/compose-spec/compose-spec/blob/master/06-networks.mdoptional--
volumesVolumes are persistent data stores implemented by the container engine. @see https://github.com/compose-spec/compose-spec/blob/master/07-volumes.mdoptional--
secretsSecrets are a flavor of Configs focusing on sensitive data, with specific constraint for this usage. @see https://github.com/compose-spec/compose-spec/blob/master/09-secrets.mdoptional--
configsConfigs allow services to adapt their behaviour without the need to rebuild a Docker image. @see https://github.com/compose-spec/compose-spec/blob/master/08-configs.mdoptional--

Modules that use feature configuration

Feature module name: AUTHORIZER
KeyDescriptionConstraintsDefaultValue
versionThe top-level version property is defined by the Compose Specification for backward compatibility. It is only informative. @see https://github.com/compose-spec/compose-spec/blob/master/04-version-and-name.mdoptional--
servicesA service is an abstract definition of a computing resource within an application which can be scaled or replaced independently from other components. @see https://github.com/compose-spec/compose-spec/blob/master/05-services.mdoptional-{"authorizer":{"image":"lakhansamani/authorizer:1.3.8","container_name":"authorizer","ports":["8080:8080"],"networks":["default-network"],"environment":{"DATABASE_NAME":"authorizer","PORT":8080,"COOKIE_NAME":"authorizer","DISABLE_PLAYGROUND":true,"ACCESS_TOKEN_EXPIRY_TIME":"30m","IMAGE":"lakhansamani/authorizer:1.3.8","EXTERNAL_CLIENT_PORT":8080,"ENV":"production","RESET_PASSWORD_URL":"/reset-password","ROLES":"user,admin","DEFAULT_ROLES":"user","JWT_ROLE_CLAIM":"role","ORGANIZATION_NAME":"Authorizer","ORGANIZATION_LOGO":"Authorizer Logo","COUCHBASE_BUCKET":"authorizer","COUCHBASE_BUCKET_RAM_QUOTA":1000,"COUCHBASE_SCOPE":"_default"},"keysOfEnvironmentsWithStaticValue":["featureName","image","networks","dependsOnServiceNames","env"],"tty":true,"restart":"always","depends_on":{}}}
networksNetworks are the layer that allow services to communicate with each other. @see https://github.com/compose-spec/compose-spec/blob/master/06-networks.mdoptional-{"default-network":{"driver":"bridge"}}
volumesVolumes are persistent data stores implemented by the container engine. @see https://github.com/compose-spec/compose-spec/blob/master/07-volumes.mdoptional--
secretsSecrets are a flavor of Configs focusing on sensitive data, with specific constraint for this usage. @see https://github.com/compose-spec/compose-spec/blob/master/09-secrets.mdoptional--
configsConfigs allow services to adapt their behaviour without the need to rebuild a Docker image. @see https://github.com/compose-spec/compose-spec/blob/master/08-configs.mdoptional--

Modules that use feature configuration

Feature module name: POSTGRE_SQL
KeyDescriptionConstraintsDefaultValue
versionThe top-level version property is defined by the Compose Specification for backward compatibility. It is only informative. @see https://github.com/compose-spec/compose-spec/blob/master/04-version-and-name.mdoptional--
servicesA service is an abstract definition of a computing resource within an application which can be scaled or replaced independently from other components. @see https://github.com/compose-spec/compose-spec/blob/master/05-services.mdoptional-{"postgre-sql":{"image":"bitnami/postgresql:15.5.0","container_name":"postgre-sql","volumes":["postgre-sql-volume:/bitnami/postgresql"],"ports":["5432:5432"],"networks":["default-network"],"healthcheck":{"test":["CMD-SHELL","pg_isready -U postgres"],"interval":"5s","timeout":"5s","retries":5},"tty":true,"restart":"always"}}
networksNetworks are the layer that allow services to communicate with each other. @see https://github.com/compose-spec/compose-spec/blob/master/06-networks.mdoptional-{"default-network":{"driver":"bridge"}}
volumesVolumes are persistent data stores implemented by the container engine. @see https://github.com/compose-spec/compose-spec/blob/master/07-volumes.mdoptional-{"postgre-sql-volume":{"name":"postgre-sql-volume"}}
secretsSecrets are a flavor of Configs focusing on sensitive data, with specific constraint for this usage. @see https://github.com/compose-spec/compose-spec/blob/master/09-secrets.mdoptional--
configsConfigs allow services to adapt their behaviour without the need to rebuild a Docker image. @see https://github.com/compose-spec/compose-spec/blob/master/08-configs.mdoptional--

Modules that use feature configuration

Feature module name: MINIO
KeyDescriptionConstraintsDefaultValue
versionThe top-level version property is defined by the Compose Specification for backward compatibility. It is only informative. @see https://github.com/compose-spec/compose-spec/blob/master/04-version-and-name.mdoptional--
servicesA service is an abstract definition of a computing resource within an application which can be scaled or replaced independently from other components. @see https://github.com/compose-spec/compose-spec/blob/master/05-services.mdoptional-{"minio":{"image":"bitnami/minio:2024.2.9","container_name":"minio","volumes":["minio-volume:/bitnami/minio/data"],"ports":["9000:9000","9001:9001"],"networks":["default-network"],"environment":{},"keysOfEnvironmentsWithStaticValue":["featureName","image","networks","nginxBucketsLocations","nginxConfigContent","nginxConfigFolder","nginxLogsFolder"],"healthcheck":{"test":["CMD-SHELL","mc","ready","local"],"interval":"5s","timeout":"5s","retries":5},"tty":true,"restart":"always"}}
networksNetworks are the layer that allow services to communicate with each other. @see https://github.com/compose-spec/compose-spec/blob/master/06-networks.mdoptional-{"default-network":{"driver":"bridge"}}
volumesVolumes are persistent data stores implemented by the container engine. @see https://github.com/compose-spec/compose-spec/blob/master/07-volumes.mdoptional-{"minio-volume":{"name":"minio-volume"}}
secretsSecrets are a flavor of Configs focusing on sensitive data, with specific constraint for this usage. @see https://github.com/compose-spec/compose-spec/blob/master/09-secrets.mdoptional--
configsConfigs allow services to adapt their behaviour without the need to rebuild a Docker image. @see https://github.com/compose-spec/compose-spec/blob/master/08-configs.mdoptional--

Back to Top


DockerComposeAuthorizer

Authorizer is an open-source authentication and authorization solution for your applications. Bring your database and have complete control over the user information. You can self-host authorizer instances and connect to supported databases. (Generator for https://authorizer.dev in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Use in NestJS-mod

An approximate description of how to connect, an extended description with an example application will be next time (todo: right now I have a lot of work and don’t have time to arrange everything properly 😉)

bootstrapNestApplication({
  globalConfigurationOptions: { debug: true },
  globalEnvironmentsOptions: { debug: true },
  modules: {
    system: [
      ProjectUtils.forRoot({
        staticConfiguration: {
          applicationPackageJsonFile: join(appFolder, PACKAGE_JSON_FILE),
          packageJsonFile: join(rootFolder, PACKAGE_JSON_FILE),
          envFile: join(rootFolder, '.env'),
        },
      }),
      DefaultNestApplicationInitializer.forRoot(),
      DefaultNestApplicationListener.forRoot({
        staticConfiguration: {
          // When running in infrastructure mode, the backend server does not start.
          mode: isInfrastructureMode() ? 'silent' : 'listen',
        },
      }),
    ],
    infrastructure: [
      DockerCompose.forRoot({
        configuration: {
          dockerComposeFileVersion: '3',
          dockerComposeFile: join(appFolder, DOCKER_COMPOSE_FILE),
        },
      }),
      DockerComposePostgreSQL.forFeature({
        featureModuleName: authorizerFeatureName,
      }),
      DockerComposeRedis.forRoot(),
      DockerComposeAuthorizer.forRoot({
        staticEnvironments: {
          redisUrl: '%SERVER_AUTHORIZER_INTERNAL_REDIS_URL%',
          databaseUrl: '%SERVER_AUTHORIZER_INTERNAL_DATABASE_URL%',
        },
        staticConfiguration: {
          featureName: authorizerFeatureName,
          organizationName: 'OrganizationName',
          dependsOnServiceNames: {
            'postgre-sql-migrations': 'service_completed_successfully',
            redis: 'service_healthy',
          },
        },
      }),
    ],
  },
});

After connecting the module to the application and npm run build and starting generation of documentation through npm run docs:infrastructure, you will have new files and scripts to run.

New scripts mostly package.json

Add database options to docker-compose file for application docker-compose.yml with real credenionals and add it to .gitignore file

version: '3'
services:
  server-authorizer:
    image: "lakhansamani/authorizer:1.3.8"
    container_name: "server-authorizer"
    ports:
      - "8080:8080"
    networks:
      - "server-network"
    environment:
      REDIS_URL: "redis://:cgSOXCMczzNFkxAmDJAsoujJYpoMDuTT@server-redis:6379"
      DATABASE_URL: "postgres://Yk42KA4sOb:B7Ep2MwlRR6fAx0frXGWVTGP850qAxM6@server-postgre-sql:5432/authorizer"
      ADMIN_SECRET: "VfKSfPPljhHBXCEohnitursmgDxfAyiD"
      DATABASE_TYPE: "postgres"
      DATABASE_NAME: "authorizer"
      FEATURE_NAME: "authorizer"
      ORGANIZATION_NAME: "OrganizationName"
      DEPENDS_ON_SERVICE_NAMES: "[object Object]"
      IMAGE: "lakhansamani/authorizer:1.3.8"
      EXTERNAL_CLIENT_PORT: "8080"
      ENV: "production"
      PORT: "8080"
      COOKIE_NAME: "authorizer"
      RESET_PASSWORD_URL: "/reset-password"
      DISABLE_PLAYGROUND: "true"
      ROLES: "user,admin"
      DEFAULT_ROLES: "user"
      JWT_ROLE_CLAIM: "role"
      ORGANIZATION_LOGO: "Authorizer Logo"
      ACCESS_TOKEN_EXPIRY_TIME: "30m"
      COUCHBASE_BUCKET: "authorizer"
      COUCHBASE_BUCKET_RAM_QUOTA: "1000"
      COUCHBASE_SCOPE: "_default"
    tty: true
    restart: "always"
    depends_on:
      server-postgre-sql-migrations:
        condition: "service_completed_successfully"
      server-redis:
        condition: "service_healthy"
networks:
  server-network:
    driver: 'bridge'

New environment variable

SERVER_AUTHORIZER_DATABASE_URL=postgres://Yk42KA4sOb:B7Ep2MwlRR6fAx0frXGWVTGP850qAxM6@server-postgre-sql:5432/authorizer?schema=public
SERVER_AUTHORIZER_REDIS_URL=redis://:cgSOXCMczzNFkxAmDJAsoujJYpoMDuTT@server-redis:6379
SERVER_AUTHORIZER_INTERNAL_DATABASE_URL=postgres://Yk42KA4sOb:B7Ep2MwlRR6fAx0frXGWVTGP850qAxM6@server-postgre-sql:5432/authorizer
SERVER_AUTHORIZER_INTERNAL_REDIS_URL=redis://:cgSOXCMczzNFkxAmDJAsoujJYpoMDuTT@server-redis:6379
# server-authorizer (generated)
REDIS_URL=redis://:cgSOXCMczzNFkxAmDJAsoujJYpoMDuTT@server-redis:6379
DATABASE_URL=postgres://Yk42KA4sOb:B7Ep2MwlRR6fAx0frXGWVTGP850qAxM6@server-postgre-sql:5432/authorizer
ADMIN_SECRET=VfKSfPPljhHBXCEohnitursmgDxfAyiD
DATABASE_TYPE=postgres
DATABASE_NAME=authorizer
FEATURE_NAME=authorizer
ORGANIZATION_NAME='OrganizationName'
IMAGE=lakhansamani/authorizer:1.3.8
EXTERNAL_CLIENT_PORT=8080
ENV=production
PORT=8080
COOKIE_NAME=authorizer
RESET_PASSWORD_URL=/reset-password
DISABLE_PLAYGROUND=true
ROLES=user,admin
DEFAULT_ROLES=user
JWT_ROLE_CLAIM=role
ORGANIZATION_LOGO='Authorizer Logo'
ACCESS_TOKEN_EXPIRY_TIME=30m
COUCHBASE_BUCKET=authorizer
COUCHBASE_BUCKET_RAM_QUOTA=1000
COUCHBASE_SCOPE=_default

When launched in the infrastructure documentation generation mode, the module creates an .env file with a list of all required variables, as well as an example example.env, where you can enter example variable values.

Static environments

KeyDescriptionSourcesConstraintsDefaultValue
adminSecretSuper admin secret used to access the master data.obj['adminSecret'], process.env['ADMIN_SECRET']isNotEmpty (adminSecret should not be empty)--
databaseTypeWhich database you are using. Supported database types are postgres, mysql, planetscale, sqlite, sqlserver, mongodb, arangodb, yugabyte, mariadb, cassandradb, scylladb, couchbase, dynamodb.obj['databaseType'], process.env['DATABASE_TYPE']isNotEmpty (databaseType should not be empty)--
databaseUrlDatabase connection string. In case of cluster url eg. for cassandra db, you can use comma separated IPs.obj['databaseUrl'], process.env['DATABASE_URL']isNotEmpty (databaseUrl should not be empty)--
databaseNameName of database to connect to. This is useful in case of arangodb and mongodb. If not set, default value will be used.obj['databaseName'], process.env['DATABASE_NAME']optionalauthorizerauthorizer
redisUrlRedis URL where sessions can be persisted false sessions will be stored in memory.obj['redisUrl'], process.env['REDIS_URL']optional--
databasePortPort on which database connection should be made. This is used when DATABASE_URL is not mentioned. At the moment supported by cassandradb.obj['databasePort'], process.env['DATABASE_PORT']optional--
databaseHostHost/IP on which database connection should be made. This is used when DATABASE_URL is not mentioned. At the moment supported by cassandradb type.obj['databaseHost'], process.env['DATABASE_HOST']optional--
databaseUsernameUsername for the database access with permission to create tables and records. At the moment supported by cassandradb, scylladb type.obj['databaseUsername'], process.env['DATABASE_USERNAME']optional--
databasePasswordPassword for the database access with permission to create tables and records. At the moment supported by cassandradb, scylladb type.obj['databasePassword'], process.env['DATABASE_PASSWORD']optional--
databaseCertBase64 encoded certificate string used to make SSL connection. At the moment supported by cassandradb,scylladb type.obj['databaseCert'], process.env['DATABASE_CERT']optional--
databaseCertKeyBase64 encoded key string used to make SSL connection. At the moment supported by cassandradb,scylladb typeobj['databaseCertKey'], process.env['DATABASE_CERT_KEY']optional--
databaseCaCertBase64 encoded CA certificate string used to make SSL connection. At the moment supported by cassandradb, scylladb type.obj['databaseCaCert'], process.env['DATABASE_CA_CERT']optional--
portPort on which server should be running.obj['port'], process.env['PORT']optional80808080
authorizerUrlDomain name of the server, eg https://authorizer.herokuapp.com.obj['authorizerUrl'], process.env['AUTHORIZER_URL']optional--
cookieNameName of cookie to be set by server.obj['cookieName'], process.env['COOKIE_NAME']optionalauthorizerauthorizer
smtpHostSMTP host is used to send email verification emails and forgot password emails false If not set email sending can fail.obj['smtpHost'], process.env['SMTP_HOST']optional--
smtpPortSMTP Port is used along with SMTP host.obj['smtpPort'], process.env['SMTP_PORT']optional--
smtpUsernameUsername for your smtp provider.obj['smtpUsername'], process.env['SMTP_USERNAME']optional--
smtpPasswordPassword for your smt providerobj['smtpPassword'], process.env['SMTP_PASSWORD']optional--
senderEmailEmail to be used in From section while sending emails.obj['senderEmail'], process.env['SENDER_EMAIL']optional--
senderNameEmail sender name that is displayed in the inbox instead of just showing the email address.obj['senderName'], process.env['SENDER_NAME']optional--
disablePlaygroundTo disable playgroundobj['disablePlayground'], process.env['DISABLE_PLAYGROUND']optionaltruetrue
accessTokenExpiryTimeTime interval for how long access token will be expired in 1h15m15s format.obj['accessTokenExpiryTime'], process.env['ACCESS_TOKEN_EXPIRY_TIME']optional30m30m
awsAccessKeyIdAWS access key used for connecting to dynamodb. Make sure access credentials has rights for dynamodb. Used with DATABASE_TYPE=dynamodb.obj['awsAccessKeyId'], process.env['AWS_ACCESS_KEY_ID']optional--
awsSecretAccessKeyAWS secret access key used for connecting to dynamodb. Make sure access credentials has rights for dynamodb. Used with DATABASE_TYPE=dynamodb.obj['awsSecretAccessKey'], process.env['AWS_SECRET_ACCESS_KEY']optional--
googleClientIdOAuth Google login client id.obj['googleClientId'], process.env['GOOGLE_CLIENT_ID']optional--
googleClientSecretOAuth Google login client secret.obj['googleClientSecret'], process.env['GOOGLE_CLIENT_SECRET']optional--
githubClientIdOAuth Github login client id.obj['githubClientId'], process.env['GITHUB_CLIENT_ID']optional--
githubClientSecretOAuth Github login client secret.obj['githubClientSecret'], process.env['GITHUB_CLIENT_SECRET']optional--
facebookClientIdOAuth Facebook login client id.obj['facebookClientId'], process.env['FACEBOOK_CLIENT_ID']optional--
facebookClientSecretOAuth Facebook login client secret.obj['facebookClientSecret'], process.env['FACEBOOK_CLIENT_SECRET']optional--
linkedinClientIdOAuth LinkedIn login client id.obj['linkedinClientId'], process.env['LINKEDIN_CLIENT_ID']optional--
linkedinClientSecretOAuth LinkedIn login client secret.obj['linkedinClientSecret'], process.env['LINKEDIN_CLIENT_SECRET']optional--
appleClientIdOAuth Apple login client id.obj['appleClientId'], process.env['APPLE_CLIENT_ID']optional--
appleClientSecretOAuth Apple login client secret.obj['appleClientSecret'], process.env['APPLE_CLIENT_SECRET']optional--
twitterClientIdOAuth Twitter login client id.obj['twitterClientId'], process.env['TWITTER_CLIENT_ID']optional--
twitterClientSecretOAuth Twitter login client secret.obj['twitterClientSecret'], process.env['TWITTER_CLIENT_SECRET']optional--
microsoftClientIdOAuth Microsoft login client id.obj['microsoftClientId'], process.env['MICROSOFT_CLIENT_ID']optional--
microsoftClientSecretOAuth Microsoft login client secret.obj['microsoftClientSecret'], process.env['MICROSOFT_CLIENT_SECRET']optional--
microsoftActiveDirectoryTenantIdMicrosoft Active Directory Tenant ID obtained from azure portal.obj['microsoftActiveDirectoryTenantId'], process.env['MICROSOFT_ACTIVE_DIRECTORY_TENANT_ID']optional--
smtpLocalName-obj['smtpLocalName'], process.env['SMTP_LOCAL_NAME']optional--
jwtSecret-obj['jwtSecret'], process.env['JWT_SECRET']optional--
jwtPrivateKey-obj['jwtPrivateKey'], process.env['JWT_PRIVATE_KEY']optional--
jwtPublicKey-obj['jwtPublicKey'], process.env['JWT_PUBLIC_KEY']optional--
appUrl-obj['appUrl'], process.env['APP_URL']optional--
discordClientId-obj['discordClientId'], process.env['DISCORD_CLIENT_ID']optional--
discordClientSecret-obj['discordClientSecret'], process.env['DISCORD_CLIENT_SECRET']optional--
twitchClientId-obj['twitchClientId'], process.env['TWITCH_CLIENT_ID']optional--
twitchClientSecret-obj['twitchClientSecret'], process.env['TWITCH_CLIENT_SECRET']optional--
clientId-obj['clientId'], process.env['CLIENT_ID']optional--
clientSecret-obj['clientSecret'], process.env['CLIENT_SECRET']optional--
encryptionKey-obj['encryptionKey'], process.env['ENCRYPTION_KEY']optional--
isProd-obj['isProd'], process.env['IS_PROD']optional--
allowedOrigins-obj['allowedOrigins'], process.env['ALLOWED_ORIGINS']optional--
twilioApiKey-obj['twilioApiKey'], process.env['TWILIO_API_KEY']optional--
twilioApiSecret-obj['twilioApiSecret'], process.env['TWILIO_API_SECRET']optional--
twilioAccountSid-obj['twilioAccountSid'], process.env['TWILIO_ACCOUNT_SID']optional--
twilioSender-obj['twilioSender'], process.env['TWILIO_SENDER']optional--

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image name.optionallakhansamani/authorizer:1.3.8-
featureNameFeature name for generate prefix to environments keys.optional--
networksNetwork, if not set networkNames have project name and driver=bridge.optional--
externalClientPortExternal port for sharing container.optional8080-
dependsOnServiceNamesDepends on servicesoptional--
envWhich env you are running your server in. Supported envs production, development.optionalproduction-
resetPasswordUrlReset password link, that can be used to send the correct forgot password link.optional/reset-password-
disableBasicAuthenticationUsed to explicitly disable email and password based authentication.optional--
disableEmailVerificationUsed to disable the email verification while signing up.optional--
disableMagicLinkLoginUsed to disable the password less login up.optional--
disableLoginPageUsed to disable the default login page that comes with authorizer instance. This is helpful when user is building their custom login page.optional--
disableSignUpUsed to disable the sign up feature. It is useful when you want to have beta release of your product and invite only limited users.optional--
rolesComma separated list of roles that your platform supports.optionaluser,admin-
defaultRolesComma separated list of roles that acts as Default roles which you would like to assign to users while they signup /login.optionaluser-
protectedRolesComma separated list of roles for which signup should be disabled. Example admin roles. This roles can only assigned manually via super admin like adminUpdateProfile.optional--
jwtRoleClaimClaim key that will be part of JWT token.optionalrole-
organizationNameName of organization that you want on default login page.optionalAuthorizer-
organizationLogoLogo of organization that you want on default login page.optionalAuthorizer Logo-
customAccessTokenScriptJavascript function to add extra keys to your JWT id token. This feature is developed using otto and only supports writing function in ES5. Check the sample here.optional--
awsRegionAWS, region id, where dynamod db tables are to be created. Used with DATABASE_TYPE=dynamodb.optional--
couchbaseBucketBucket used for couchbase database. Used with DATABASE_TYPE=couchbase.optionalauthorizer-
couchbaseBucketRamQuotaRAM Quota for the bucket used for couchbase database. It has to be numeric value only. Used with DATABASE_TYPE=couchbase.optional1000-
couchbaseScopeScope in which bucket is created. Used with DATABASE_TYPE=couchbase.optional_default-
test-optional--
envPath-optional--
isEmailServiceEnabled-optional--
isSmsServiceEnabled-optional--
appCookieSecure-optional--
adminCookieSecure-optional--
jwtType-optional--
jwk-optional--
disableMobileBasicAuthentication-optional--
disableRedisForEnv-optional--
disableStrongPassword-optional--
enforceMultiFactorAuthentication-optional--
disableMultiFactorAuthentication-optional--
disableTotpLogin-optional--
disableMailOtpLogin-optional--
disablePhoneVerification-optional--
defaultAuthorizeResponseType-optional--
defaultAuthorizeResponseMode-optional--

Back to Top


DockerComposeMinio

MinIO is a high-performance, S3 compatible object storage. (Generator for minio in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Use in NestJS-mod

An example of using Minio, you can see the full example here https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-minio and frontend on Angular here https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-minio-angular.

import {
  DefaultNestApplicationInitializer,
  DefaultNestApplicationListener,
  InfrastructureMarkdownReportGenerator,
  PACKAGE_JSON_FILE,
  ProjectUtils,
  bootstrapNestApplication,
  isInfrastructureMode,
} from '@nestjs-mod/common';
import { join } from 'path';

import { DOCKER_COMPOSE_FILE, DockerCompose, DockerComposeMinio } from '@nestjs-mod/docker-compose';

const userFeatureName = 'minio-user';
const rootFolder = join(__dirname, '..', '..', '..');
const appFolder = join(rootFolder, 'apps', 'example-minio');

bootstrapNestApplication({
  globalConfigurationOptions: { debug: true },
  globalEnvironmentsOptions: { debug: true },
  modules: {
    system: [
      ProjectUtils.forRoot({
        staticConfiguration: {
          applicationPackageJsonFile: join(appFolder, PACKAGE_JSON_FILE),
          packageJsonFile: join(rootFolder, PACKAGE_JSON_FILE),
          envFile: join(rootFolder, '.env'),
        },
      }),
      DefaultNestApplicationInitializer.forRoot(),
      DefaultNestApplicationListener.forRoot({
        staticConfiguration: {
          // When running in infrastructure mode, the backend server does not start.
          mode: isInfrastructureMode() ? 'silent' : 'listen',
        },
      }),
    ],
    infrastructure: [
      InfrastructureMarkdownReportGenerator.forRoot({
        staticConfiguration: {
          markdownFile: join(appFolder, 'INFRASTRUCTURE.MD'),
          skipEmptySettings: true,
        },
      }),
      DockerCompose.forRoot({
        configuration: {
          dockerComposeFileVersion: '3',
          dockerComposeFile: join(appFolder, DOCKER_COMPOSE_FILE),
        },
      }),
      DockerComposeMinio.forRoot({
        staticConfiguration: {
          nginxPort: 1111,
          nginxFilesFolder: join(appFolder, 'ngnix'),
          featureName: userFeatureName,
        },
      }),
    ],
  },
});

After connecting the module to the application and npm run build and starting generation of documentation through npm run docs:infrastructure, you will have new files and scripts to run.

New scripts mostly package.json

Add database options to docker-compose file for application docker-compose.yml with real credenionals and add it to .gitignore file

version: '3'
services:
  example-minio-minio:
    image: 'bitnami/minio:2024.2.9'
    container_name: 'example-minio-minio'
    volumes:
      - 'example-minio-minio-volume:/bitnami/minio/data'
    ports:
      - '9000:9000'
      - '9001:9001'
    networks:
      - 'example-minio-network'
    environment:
      MINIO_ROOT_USER: 'minioadmin'
      MINIO_ROOT_PASSWORD: '6EcbcW66JsKvFrY2bZw6QGKjHhefca7Kgppq'
    healthcheck:
      test:
        - 'CMD-SHELL'
        - 'mc'
        - 'ready'
        - 'local'
      interval: '5s'
      timeout: '5s'
      retries: 5
    tty: true
    restart: 'always'
  example-minio-nginx:
    image: 'nginx:alpine'
    container_name: 'example-minio-nginx'
    volumes:
      - './ngnix/config:/etc/nginx/conf.d'
      - './ngnix/logs:/var/log/nginx/'
    ports:
      - '1111:1111'
    networks:
      - 'example-minio-network'
    tty: true
    restart: 'always'
    depends_on:
      example-minio-minio:
        condition: 'service_started'
networks:
  example-minio-network:
    driver: 'bridge'
volumes:
  example-minio-minio-volume:
    name: 'example-minio-minio-volume'

Add database options to docker-compose file for application docker-compose-example.yml with fake credenionals

# Do not modify this file, it is generated using the DockerCompose module included with NestJS-mod.
version: '3'
services:
  example-minio-minio:
    image: 'bitnami/minio:2024.2.9'
    container_name: 'example-minio-minio'
    volumes:
      - 'example-minio-minio-volume:/bitnami/minio/data'
    ports:
      - '9000:9000'
      - '9001:9001'
    networks:
      - 'example-minio-network'
    environment:
      MINIO_ROOT_USER: 'value_for_minio_root_user'
      MINIO_ROOT_PASSWORD: 'value_for_minio_root_password'
    healthcheck:
      test:
        - 'CMD-SHELL'
        - 'mc'
        - 'ready'
        - 'local'
      interval: '5s'
      timeout: '5s'
      retries: 5
    tty: true
    restart: 'always'
  example-minio-nginx:
    image: 'nginx:alpine'
    container_name: 'example-minio-nginx'
    volumes:
      - './ngnix/config:/etc/nginx/conf.d'
      - './ngnix/logs:/var/log/nginx/'
    ports:
      - '1111:1111'
    networks:
      - 'example-minio-network'
    tty: true
    restart: 'always'
    depends_on:
      example-minio-minio:
        condition: 'service_started'
networks:
  example-minio-network:
    driver: 'bridge'
volumes:
  example-minio-minio-volume:
    name: 'example-minio-minio-volume'

New environment variable

EXAMPLE_MINIO_MINIO_USER_MINIO_ROOT_USER=minioadmin
EXAMPLE_MINIO_MINIO_USER_MINIO_ROOT_PASSWORD=6EcbcW66JsKvFrY2bZw6QGKjHhefca7Kgppq

When launched in the infrastructure documentation generation mode, the module creates an .env file with a list of all required variables, as well as an example example.env, where you can enter example variable values.

Static environments

KeyDescriptionSourcesConstraintsDefaultValue
minioRootUserMinio root user.obj['minioRootUser'], process.env['MINIO_ROOT_USER']isNotEmpty (minioRootUser should not be empty)--
minioRootPasswordMinio root password.obj['minioRootPassword'], process.env['MINIO_ROOT_PASSWORD']isNotEmpty (minioRootPassword should not be empty)--

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image nameoptionalbitnami/minio:2024.2.9-
featureNameFeature name for generate prefix to environments keysoptional--
networksNetwork, if not set networkNames have project name and driver=bridge.optional--
externalPortExternal port for S3 API operations on the default MinIO server port.optional9000-
externalConsolePortExternal console for browser access on the MinIO Console port.optional9001-
nginxPortExternal port for proxy access over nginx (infrastructure, need for disable CORS errors)optional--
nginxConfigFolderFolder for store nginx config (infrastructure)optional--
nginxLogsFolderFolder for store nginx logs (infrastructure)optional--
nginxBucketsLocationsLocations for proxy to minio (infrastructure)optional files -
nginxConfigContentCustom nginx config content (infrastructure)optional--

Back to Top


DockerComposeNats

NATS is an open source, lightweight and high-performance messaging system. It is ideal for distributed systems and supports modern cloud architectures and pub-sub, request-reply and queuing models. (Generator for nats in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Static environments

KeyDescriptionSourcesConstraintsDefaultValue
natsEnableAuthEnable Authentication.obj['natsEnableAuth'], process.env['NATS_ENABLE_AUTH']optional--
natsUsernameUsername credential for client connections.obj['natsUsername'], process.env['NATS_USERNAME']optional--
natsPasswordPassword credential for client connections.obj['natsPassword'], process.env['NATS_PASSWORD']optional--

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image name.optionalbitnami/nats:2.10.5-
featureNameFeature name for generate prefix to environments keysoptional--
networksNetwork, if not set networkNames have project name and driver=bridge.optional--
externalClientPortExternal client port for sharing container.optional4222-
externalHttpPortExternal http port for sharing container.optional8222-
extraArgsExtra arguments.optional-js-

Back to Top


DockerComposeNginx

Nginx is a web server that can also be used as a reverse proxy, load balancer, mail proxy and HTTP cache. (Generator for nginx in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image nameoptionalnginx:alpine-
configContentConfig contentisNotEmpty (configContent should not be empty)--
configFolderConfig folder for map volume to /etc/nginx/conf.disNotEmpty (configFolder should not be empty)--
logsFolderLogs folder for map volume to /var/log/nginx/optional--
dependsOnServiceNamesDepends on servicesoptional--
portsPortsoptional--
networksNetwork, if not set networkNames have project name and driver=bridge.optional--

Back to Top


DockerComposePostgreSQL

PostgreSQL (Postgres) is an open source object-relational database known for reliability and data integrity. ACID-compliant, it supports foreign keys, joins, views, triggers and stored procedures. (Generator for databases in docker-compose.yml for https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/libs/infrastructure/docker-compose)

Use in NestJS-mod

An example you can see the full example here https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-prisma-flyway or https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-prisma.

import {
  DefaultNestApplicationInitializer,
  DefaultNestApplicationListener,
  PACKAGE_JSON_FILE,
  ProjectUtils,
  bootstrapNestApplication,
} from '@nestjs-mod/common';
import { DOCKER_COMPOSE_FILE, DockerCompose, DockerComposePostgreSQL } from '@nestjs-mod/docker-compose';
import { join } from 'path';

export const flywayPrismaFeatureName = 'flyway-prisma';

const rootFolder = join(__dirname, '..', '..', '..');
const appFolder = join(rootFolder, 'apps', 'example-prisma-flyway');

bootstrapNestApplication({
  modules: {
    system: [
      ProjectUtils.forRoot({
        staticConfiguration: {
          applicationPackageJsonFile: join(appFolder, PACKAGE_JSON_FILE),
          packageJsonFile: join(rootFolder, PACKAGE_JSON_FILE),
          envFile: join(rootFolder, '.env'),
        },
      }),
      DefaultNestApplicationInitializer.forRoot(),
      DefaultNestApplicationListener.forRoot({
        staticConfiguration: {
          // When running in infrastructure mode, the backend server does not start.
          mode: isInfrastructureMode() ? 'silent' : 'listen',
        },
      }),
    ],
    infrastructure: [
      DockerCompose.forRoot({
        configuration: {
          dockerComposeFileVersion: '3',
          dockerComposeFile: join(appFolder, DOCKER_COMPOSE_FILE),
        },
      }),
      DockerComposePostgreSQL.forRoot(),
      DockerComposePostgreSQL.forFeature({
        featureModuleName: flywayPrismaFeatureName,
      }),
    ],
  },
});

After connecting the module to the application and npm run build and starting generation of documentation through npm run docs:infrastructure, you will have new files and scripts to run.

New scripts mostly package.json

{
  "scripts": {
    "_____db_____": "_____db_____",
    "db:create": "./node_modules/.bin/nx run-many --exclude=@nestjs-mod/contrib -t=db-create"
  },
  "scriptsComments": {
    "db:create": ["Creation all databases of applications and modules"]
  }
}

Additional commands in the nx application project.json

{
  "targets": {
    "db-create": {
      "executor": "nx:run-commands",
      "options": {
        "commands": [
          "./node_modules/.bin/rucken postgres --force-change-username=true --force-change-password=true --root-database-url=${EXAMPLE_PRISMA_FLYWAY_ROOT_DATABASE_URL} --app-database-url=${EXAMPLE_PRISMA_FLYWAY_FLYWAY_PRISMA_DATABASE_URL}"
        ],
        "parallel": false,
        "envFile": "./.env",
        "color": true
      }
    }
  }
}

Add database options to docker-compose file for application docker-compose.yml with real credenionals and add it to .gitignore file

version: '3'
services:
  example-prisma-flyway-postgre-sql:
    image: bitnami/postgresql:15.5.0
    container_name: example-prisma-flyway-postgre-sql
    volumes:
      - example-prisma-flyway-postgre-sql-volume:/bitnami/postgresql
    ports:
      - 5432:5432
    networks:
      - example-prisma-flyway-network
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U postgres
      interval: 5s
      timeout: 5s
      retries: 5
    tty: true
    restart: always
    environment:
      POSTGRESQL_USERNAME: postgres
      POSTGRESQL_PASSWORD: postgres_password
      POSTGRESQL_DATABASE: postgres
networks:
  example-prisma-flyway-network:
    driver: bridge
volumes:
  example-prisma-flyway-postgre-sql-volume:
    name: example-prisma-flyway-postgre-sql-volume

Add database options to docker-compose file for application docker-compose-example.yml with fake credenionals

# Do not modify this file, it is generated using the DockerCompose module included with NestJS-mod.
version: '3'
services:
  example-prisma-flyway-postgre-sql:
    image: bitnami/postgresql:15.5.0
    container_name: example-prisma-flyway-postgre-sql
    volumes:
      - example-prisma-flyway-postgre-sql-volume:/bitnami/postgresql
    ports:
      - 5432:5432
    networks:
      - example-prisma-flyway-network
    healthcheck:
      test:
        - CMD-SHELL
        - pg_isready -U postgres
      interval: 5s
      timeout: 5s
      retries: 5
    tty: true
    restart: always
    environment:
      POSTGRESQL_USERNAME: value_for_postgresql_username
      POSTGRESQL_PASSWORD: value_for_postgresql_password
      POSTGRESQL_DATABASE: value_for_postgresql_database
networks:
  example-prisma-flyway-network:
    driver: bridge
volumes:
  example-prisma-flyway-postgre-sql-volume:
    name: example-prisma-flyway-postgre-sql-volume

Static environments

KeyDescriptionSourcesConstraintsDefaultValue
rootDatabaseUrlConnection string for PostgreSQL with root credentials (example: postgres://postgres:postgres_password@localhost:5432/postgres?schema=public, username must be "postgres")obj['rootDatabaseUrl'], process.env['ROOT_DATABASE_URL']isNotEmpty (rootDatabaseUrl should not be empty)--

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image nameoptionalbitnami/postgresql:15.5.0-
networksNetwork, if not set networkNames have project name and driver=bridge.optional--
externalPortExternal port for sharing container.optional5432-

Feature environments

KeyDescriptionSourcesConstraintsDefaultValue
databaseUrlConnection string for PostgreSQL with module credentials (example: postgres://feat:feat_password@localhost:5432/feat?schema=public)obj['databaseUrl'], process.env['DATABASE_URL']isNotEmpty (databaseUrl should not be empty)--

Back to Top


DockerComposeRedis

The open-source, in-memory data store used by millions of developers as a cache, vector database, document database, streaming engine, and message broker. (Generator for redis in docker-compose.yml for https://www.npmjs.com/package/@nestjs-mod/docker-compose)

Use in NestJS-mod

An example you can see the full example here https://github.com/nestjs-mod/nestjs-mod-contrib/tree/master/apps/example-cache-manager.

import {
  DefaultNestApplicationInitializer,
  DefaultNestApplicationListener,
  InfrastructureMarkdownReportGenerator,
  PACKAGE_JSON_FILE,
  ProjectUtils,
  bootstrapNestApplication,
} from '@nestjs-mod/common';
import { DOCKER_COMPOSE_FILE, DockerCompose, DockerComposeRedis } from '@nestjs-mod/docker-compose';
import { join } from 'path';
import { userFeatureName } from './app/app.constants';

const rootFolder = join(__dirname, '..', '..', '..');
const appFolder = join(rootFolder, 'apps', 'example-cache-manager');

bootstrapNestApplication({
  globalConfigurationOptions: { debug: true },
  globalEnvironmentsOptions: { debug: true },
  modules: {
    system: [
      ProjectUtils.forRoot({
        staticConfiguration: {
          applicationPackageJsonFile: join(
            __dirname,
            '..',
            '..',
            '..',
            'apps/example-cache-manager',
            PACKAGE_JSON_FILE
          ),
          packageJsonFile: join(rootFolder, PACKAGE_JSON_FILE),
          envFile: join(rootFolder, '.env'),
        },
      }),
      DefaultNestApplicationInitializer.forRoot(),
      DefaultNestApplicationListener.forRoot({
        staticConfiguration: {
          // When running in infrastructure mode, the backend server does not start.
          mode: isInfrastructureMode() ? 'silent' : 'listen',
        },
      }),
    ],
    infrastructure: [
      InfrastructureMarkdownReportGenerator.forRoot({
        staticConfiguration: {
          markdownFile: join(appFolder, 'INFRASTRUCTURE.MD'),
          skipEmptySettings: true,
        },
      }),
      DockerCompose.forRoot({
        configuration: {
          dockerComposeFileVersion: '3',
          dockerComposeFile: join(appFolder, DOCKER_COMPOSE_FILE),
        },
      }),
      DockerComposeRedis.forRoot({ staticConfiguration: { featureName: userFeatureName } }),
    ],
  },
});

After connecting the module to the application and npm run build and starting generation of documentation through npm run docs:infrastructure, you will have new files and scripts to run.

New scripts mostly package.json

Add database options to docker-compose file for application docker-compose.yml with real credenionals and add it to .gitignore file

version: '3'
services:
  cache-manager-redis:
    image: 'bitnami/redis:7.2'
    container_name: 'cache-manager-redis'
    volumes:
      - 'cache-manager-redis-volume:/bitnami/redis/data'
    ports:
      - '6379:6379'
    networks:
      - 'cache-manager-network'
    environment:
      REDIS_DATABASE: '0'
      REDIS_PASSWORD: 'redis_password'
      REDIS_DISABLE_COMMANDS: 'FLUSHDB,FLUSHALL'
      REDIS_IO_THREADS: 2
      REDIS_IO_THREADS_DO_READS: 'yes'
    healthcheck:
      test:
        - 'CMD-SHELL'
        - 'redis-cli ping | grep PONG'
      interval: '5s'
      timeout: '5s'
      retries: 5
    tty: true
    restart: 'always'
networks:
  example-cache-manager-network:
    driver: bridge
volumes:
  example-cache-manager-volume:
    name: example-cache-manager-volume

Add database options to docker-compose file for application docker-compose-example.yml with fake credenionals

# Do not modify this file, it is generated using the DockerCompose module included with NestJS-mod.
version: '3'
services:
  cache-manager-redis:
    image: 'bitnami/redis:7.2'
    container_name: 'cache-manager-redis'
    volumes:
      - 'cache-manager-redis-volume:/bitnami/redis/data'
    ports:
      - '6379:6379'
    networks:
      - 'cache-manager-network'
    environment:
      REDIS_DATABASE: 'value_for_redis_database'
      REDIS_PASSWORD: 'value_for_redis_password'
      REDIS_DISABLE_COMMANDS: 'value_for_redis_disable_commands'
      REDIS_IO_THREADS: 'value_for_redis_io_threads'
      REDIS_IO_THREADS_DO_READS: 'value_for_redis_io_threads_do_reads'
    healthcheck:
      test:
        - 'CMD-SHELL'
        - 'redis-cli ping | grep PONG'
      interval: '5s'
      timeout: '5s'
      retries: 5
    tty: true
    restart: 'always'
networks:
  example-cache-manager-network:
    driver: bridge
volumes:
  example-cache-manager-volume:
    name: example-cache-manager-volume

New environment variable

EXAMPLE_CACHE_MANAGER_CACHE_MANAGER_USER_REDIS_URL=redis://:redis_password@localhost:6379

When launched in the infrastructure documentation generation mode, the module creates an .env file with a list of all required variables, as well as an example example.env, where you can enter example variable values.

Static environments

KeyDescriptionSourcesConstraintsDefaultValue
redisUrlConnection string for Redis (example: redis://:redis_password@localhost:6379)obj['redisUrl'], process.env['REDIS_URL']isNotEmpty (redisUrl should not be empty)--

Static configuration

KeyDescriptionConstraintsDefaultValue
imageDocker image nameoptionalbitnami/redis:7.2-
featureNameFeature name for generate prefix to environments keysoptional--
networksNetwork, if not set networkNames have project name and driver=bridge.optional--
externalPortExternal port for sharing container.optional6379-
disableCommandsRedis disable commands.optionalFLUSHDB,FLUSHALL-
ioThreadsRedis IO threads.optional2-
ioThreadsDoReadsRedis IO threads.optionalyes-

Back to Top

Links

License

MIT

1.14.0

1 month ago

1.13.1

2 months ago

1.13.0

2 months ago

1.11.2

2 months ago

1.12.0

2 months ago

1.11.1

2 months ago

1.11.0

2 months ago

1.10.3

2 months ago

1.10.2

2 months ago

1.10.1

2 months ago

1.9.1

2 months ago

1.9.4

2 months ago

1.9.3

2 months ago

1.9.2

2 months ago

1.10.0

2 months ago

1.9.0

2 months ago

1.8.2

2 months ago

1.8.3

2 months ago

1.8.1

2 months ago

1.8.0

2 months ago

1.7.0

3 months ago

1.6.1

3 months ago

1.6.0

3 months ago

1.5.0

3 months ago

1.4.0

3 months ago

1.3.2

3 months ago

1.3.1

3 months ago

1.3.0

3 months ago

1.2.0

3 months ago

1.2.1

3 months ago

1.1.3

3 months ago

1.1.2

3 months ago

1.1.1

3 months ago

1.1.0

3 months ago

1.0.0

3 months ago