Instalación
Docker-Compose
Dependecy-track dispone de imagenes de docker ya preparadas por lo que solo tenemos que realizar unas pequeñas configuraciones.
Lo primero que vamos a realizar es crear un fichero .env
con los datos de configuración de la base de datos.
USERDB=dtrackOSDO
PASSWORDDB=dtrackPassword
DTRACKDB=dtrack
Creamos la red para conectar el dependency-track con el traefik
docker network create dtrack
A continuación creamos el fichero docker-compose.yml
en el vemos 3 contenedores
- Base de datos en postgres
- API
- Frontal
La base de datos si es para probarlo no es necesario, la propia api tiene su base de datos interna, si quitamos las lienas de ALPINE_DATABASE
.
Tenemos que cambiar en el label de traefik del Host example.com
por el dominio que queramos.
services:
dtrack-postgres:
image: postgres@sha256:f1314058032e52cce689f2daf3fffe7c136775e3fdd1af3fb36ae5cdc61c7891
container_name: dtrack-postgres
environment:
- POSTGRES_USER=${USERDB}
- POSTGRES_PASSWORD=${PASSWORDDB}
- POSTGRES_DB=${DTRACKDB}
volumes:
- postgres_data:/var/lib/postgresql/data
restart: unless-stopped
networks:
- dtrack
labels:
- "traefik.enable=false"
dtrack-apiserver:
image: dependencytrack/apiserver@sha256:bffd457f60dd4aed9a005d20b2a42b7307930518c2a081d1c28baa2c319f391d
container_name: dtrack-api
environment:
- ALPINE_DATABASE_MODE=external
- ALPINE_DATABASE_URL=jdbc:postgresql://dtrack-postgres:5432/${DTRACKDB}
- ALPINE_DATABASE_DRIVER=org.postgresql.Driver
- ALPINE_DATABASE_USERNAME=${USERDB}
- ALPINE_DATABASE_PASSWORD=${PASSWORDDB}
deploy:
resources:
limits:
memory: 12288m
reservations:
memory: 8192m
restart_policy:
condition: on-failure
volumes:
- 'dependency-track:/data'
restart: unless-stopped
depends_on:
- dtrack-postgres
labels:
- "traefik.enable=true"
- "traefik.http.routers.dtrackapi.rule=Host(`dtrack-api.example.com`)"
- "traefik.http.routers.dtrackapi.entrypoints=websecure"
- "traefik.http.routers.dtrackapi.tls=true"
- "traefik.http.routers.dtrackapi.tls.certresolver=le"
networks:
- dtrack
dtrack-frontend:
image: dependencytrack/frontend@sha256:63d6a6cc9f4cab15a056d4ec1ba9f8a87203415e8f1f73741fadee7f93bc191e
container_name: dtrack
depends_on:
- dtrack-apiserver
environment:
# The base URL of the API server.
# NOTE:
# * This URL must be reachable by the browsers of your users.
# * The frontend container itself does NOT communicate with the API server directly, it just serves static files.
# * When deploying to dedicated servers, please use the external IP or domain of the API server.
- API_BASE_URL=https://dtrack-api.example.com
labels:
- "traefik.enable=true"
- "traefik.http.routers.dtrack.rule=Host(`dtrack.example.com`)"
- "traefik.http.routers.dtrack.entrypoints=websecure"
- "traefik.http.routers.dtrack.tls=true"
- "traefik.http.routers.dtrack.tls.certresolver=le"
restart: unless-stopped
networks:
- dtrack
networks:
dtrack:
external: true
volumes:
postgres_data:
dependency-track:
Antes de arrancarlo acordaros de añadir la red en traefik
Necesita por lo menos 4G de ram en el host o el contenedor no arrancara.
Arrancamos los contenedores. Esto puede llevar algún tiempo, mientras el sistema java arranca.
docker-compose up -d
Kubernetes
Para proceder a la instalacion de DependencyTrack en nuestra plataforma como con otras herramientas primero necesitamos clonar el repositorio del mismo, para asi poder ver los valores que deseamos utilizar en nuestro despliegue.
https://github.com/DependencyTrack/dependency-track
Clonamos el repositorio
git clone https://github.com/DependencyTrack/dependency-track
para poder ubicar el chart de helm y validar las configuraiones que queremos realizar. Luego procedemos a agregar el chart en nuestro Kubernetes con
helm repo add evryfs-oss https://evryfs.github.io/helm-charts/
Aqui tenemos dos opciones, o copiamos y modificamos el values.yaml que podemos conseguir en la siguietne ruta o creamos uno nuevo. Si lo clonamos vamos al directorio donde se encuentra el values.yaml.
cd charts/dependency-track/
En este archivo debemos tener los siguientes parametros:
frontend:
enabled: true
annotations: {}
replicaCount: 2
image:
repository: dependencytrack/frontend
tag: 4.6.1
pullPolicy: IfNotPresent
env:
- name: API_BASE_URL
value: "https://dtrack.yourdomain.com"
# -- configuration of ingress
ingress:
enabled: true
tls:
enabled: true
secretName: "osdo-certs"
annotations: {}
# kubernetes.io/ingress.class: nginx
# kubernetes.io/tls-acme: "true"
## allow large bom.xml uploads:
# nginx.ingress.kubernetes.io/proxy-body-size: 10m
host: dtrack.opensecdevops.com
ingressClassName: appsec-nginx
luego procedemos a instalar con helm.
helm upgrade --install dependency-track evryfs-oss/dependency-track -f values.yaml -n dependency-track --create-namespace
Del anterior comando podemos notar los siguientes detalle:
- Se usa 'helm upgrade --install' porque si no existe los instale y si existe lo actualice.
- Se usa '--create-namespace' para que cree el namespace en Kuberentes si no esta creado.
- Se usa '-n dependency-track' para indicar el namespace donde queremos instalar nuestra aplicacion.