Puntos de código

Los puntos de código están relacionados con un lenguaje de código fuente compatible, incluido:

• Node.js (con npm, Yarn o Gradle)
• Java (con Maven o Gradle)
• Golang
• Python
• Dockerfile
• Lenguaje de configuración de Terraform

Los puntos ' code ' gestionan los siguientes procesos:

• building: Define las herramientas que realizan la compilación del código fuente dado.
• unit-testing: Localiza las herramientas que realizan las pruebas unitarias del resultado de la compilación.

Puntos de despliegue

Los puntos " deployment " localizan un vehículo de despliegue, incluidos los recursos y herramientas de despliegue. los puntos deployment " tienen un proceso de despliegue que enumera las herramientas de despliegue. Los vehículos de despliegue admitidos actualmente son:

• Definiciones de recursos Kubernetes como ' Pod, ' ReplicaSet, ' ReplicationController, ' Deployment, ' Daemonset, ' StatefulSet, ' Job, ' Cronjob, ' NetworkPolicy, ' Ingress, ' Service, ' Route- kubectl como herramienta

• Websphere Liberty Application Custom Resource- kubectl como herramienta

• Open Liberty Application Custom Resource- kubectl como herramienta

• Mapa delHelm- el timón como herramienta

• Configuración de Terraform- IBM Cloud Schematics o Terraform CLI como herramienta

• Wazi DeploymentMethod Recurso Personalizado- Wazi Deploy como herramienta

• Dockerfile cuando IBM Cloud Code Engine ha sido configurado para el despliegue- IBM Cloud Code Engine CLI como herramienta

Puntos de prueba de aceptación

Los puntos " acceptance-test " localizan un conjunto de pruebas de aceptación que hay que ejecutar. los puntos " acceptance-test " tienen un proceso " acceptance-testing " que identifica las herramientas para ejecutar el conjunto de pruebas de aceptación.

Puntos de escaneado dinámico

Los puntos " dynamic-scan " identifican ubicaciones para una exploración dinámica. Los puntos de escaneo dinámico tienen un proceso ' scanning ' para listar las herramientas de escaneo invocadas durante el escaneo dinámico.

El escaneo OWASP ZAP es la única herramienta soportada para iniciar un sub-webhook trigger.

Puntos de liberación

Los puntos ' release ' localizan el proceso de liberación. Los puntos de publicación tienen un proceso " releasing " que enumera las herramientas que deben ejecutarse durante la fase de publicación. Actualmente, las herramientas admitidas para el proceso de liberación son:

• liberación semántica
• maven con fase ' maven deploy '.

Configuración de la rama de inyección

Puede configurar el nombre de la rama para inyectar archivos inferidos DevSecOps utilizando la propiedad de canalización ' inferred-devsecops-branch. El valor predeterminado es inferred-devsecops.

Utilice la propiedad push-inferred-pipeline-configuration-files pipeline (la propiedad push-polyglot-files está obsoleta en favor de la propiedad push-inferred-pipeline-configuration-files ) para activar o desactivar la creación y actualización de la rama inferred-devsecops:

Ignorar las manchas

Puede ignorar puntos específicos durante la extracción utilizando expresiones regulares. Están disponibles las opciones de configuración siguientes:

• ignore-code-spot-pattern: Ignora los puntos de código que coincidan con la expresión regular especificada.
• ignore-deployment-spot-pattern: Ignora los puntos de despliegue que coincidan con la expresión regular especificada.
• ignore-dynamic-scan-spot-pattern: Ignora los puntos de escaneo dinámico que coincidan con la expresión regular especificada.
• ignore-acceptance-test-spot-pattern: Ignora los puntos de la prueba de aceptación que coincidan con la expresión regular especificada.
• ignore-release-spot-pattern: Ignora los puntos de liberación que coinciden con la expresión regular especificada.

Configuración Code Engine

Si utiliza IBM Cloud Code Engine para la implantación, especifique el proyecto Code Engine y configure el proceso de compilación con las siguientes propiedades de entorno de canalización:

• code-engine-project: Especifica el proyecto Code Engine.
• code-engine-build-use-native-docker: (Por defecto: ' false) Indica si se debe utilizar Docker CLI en lugar del comando ' ibmcloud code-engine buildrun.
• code-engine-disable-buildpacks-strategy: (Por defecto false) Indica que el proceso de compilación no debe utilizar la estrategia buildpacks (sólo válido si se ha establecido code-engine-project )
• root-as-build-context: (Predeterminado: false ) indica que el contexto de compilación para una herramienta de compilación relacionada con Dockerfile (como docker o code-engine ) debe utilizar la raíz del repositorio como contexto de compilación y no la carpeta que contiene el Dockerfile.

Configuración de la compilación de la imagen del contenedor

• container-image-builder: (Predeterminado docker) Para compilaciones relacionadas con Dockerfile, especifique la herramienta que se utilizará (docker o podman) para compilar la imagen del contenedor.
• root-as-build-context: (Predeterminado: false) indica que el contexto de compilación para la herramienta Dockerfile de compilación relacionada (como docker, podman o code-engine) debe utilizar la raíz del repositorio como contexto de compilación y no la carpeta que contiene el archivo Dockerfile.

Golang Configuración

Para configurar el proceso de extracción puntual para Golang, establezca las siguientes propiedades de entorno de canalización:

• go-ignore-main: (Por defecto: ' false) Indica si la extracción de puntos de código no debe centrarse en la detección del paquete principal y la función principal para el argumento fuente principal.
• go-output: Especifica el archivo de salida ejecutable del comando go build.

Configuración de Gradle

Para configurar las tareas de Gradle para la configuración, las pruebas unitarias, el artefacto de compilación y las pruebas de aceptación, utilice las siguientes propiedades de entorno de canalización:

• gradle-setup-tasks: (Por defecto: ' assemble) Lista separada por comas de tareas Gradle para la etapa de configuración.
• gradle-unit-testing-tasks: (Por defecto: ' test) Lista separada por comas de tareas Gradle para la etapa de prueba unitaria.
• gradle-build-artifact-tasks: (Por defecto: ' build) Lista separada por comas de tareas Gradle para la etapa build-artifact.
• gradle-acceptance-testing-tasks: Lista separada por comas de tareas Gradle para la etapa de prueba de aceptación.

Configuración de NPM

Puede configurar la detección de secuencias de comandos de pruebas unitarias y pruebas de aceptación de NPM.

• hint-npm-unit-testing-script: (Por defecto: ' test) Sugerencias para la detección de scripts de pruebas unitarias NPM.
• hint-npm-acceptance-testing-script: (Por defecto: ' acceptance-test) Sugerencias para la detección de scripts de pruebas de aceptación de NPM.

Configuración de Python

Para configurar la versión de Python Poetry, utilice las siguientes propiedades de entorno de canalización:

• hint-python-poetry-version: (Por defecto: ' 1.8.2) Sugerencias para la versión de Python Poetry.
• discover-python-unittest-from-ancestor: (Por defecto: false) indica que el directorio antecesor se utiliza como punto de partida para el descubrimiento de python unittest (por ejemplo, para descubrir pruebas unitarias desde el directorio que contiene el requirements.txt en la raíz del repositorio y no el requirements.txt (si existe) que está más cerca de los archivos unittest de python).

Configuración de Terraform

Para configurar el proceso de despliegue de Terraform, utilice las siguientes propiedades de entorno de canalización:

• terraform-deployment: (Por defecto: ' false) Desactiva Schematics como vehículo de despliegue en favor de Terraform y Cloud Object Storage para el almacenamiento de estados.

Helm configuración

Para configurar el proceso de lanzamiento de Helm, utilice las siguientes propiedades del entorno de canalización:

• helm-oci-registry-support: (Predeterminado false) Habilitar el envío del gráfico Helm al registro OCI en el paso de lanzamiento.
• configuration-file-pattern-<config_file_type>: Define un patrón para identificar los archivos de configuración de un tipo determinado. Por ejemplo, configuration-file-pattern-dev-config=chart/dev-values.yaml seleccionará los archivos chart/dev-values.yaml como artefactos de tipo dev-config.

Carga de artefactos

Para configurar el proceso de carga de artefactos, utilice las siguientes propiedades de entorno de canalización:

• artifact-upload-to-devsecops-cos: (Predeterminado: ' false) Habilita la carga de artefactos en un bucket Cloud Object Storage mediante la carga de artefactos de la CLI de DevSecOps para artefactos no guardados en imágenes.

Inyección de variables de entorno en etapas de ejecución de canalizaciones

La función Inferred DevSecOps Pipeline Configuration proporciona una utilidad " export-properties " para exportar propiedades de canalización y activación como variables de entorno durante la ejecución de la etapa. Esta utilidad se invoca en cada etapa personalizada:

export-properties "GLOBAL" && export-properties "${STAGE^^}"

Ejecución y configuración de herramientas

Algunas herramientas de la función Inferred DevSecOps Pipeline Configuration utilizan propiedades de canalización y activación para inferir la configuración complementaria.

Activar la protección de ramas por defecto

Los pipelines DevSecOps PR y CI habilitan la protección de ramas en el repositorio de código fuente por defecto. Esta verificación tiene lugar durante la fase de configuración del código.

Desactivar la protección de rama

Para desactivar la protección de ramas, establezca la propiedad " setup-branch-protection " en " false.

Personalizar las comprobaciones de estado de la protección de sucursales

Para personalizar el prefijo de las comprobaciones del estado de protección de la rama, establezca la propiedad ' branch-protection-status-check-prefix. El prefijo por defecto es ' tekton.

Configurar Poesía para Repositorios Privados

Cuando se utiliza Poetry (pyproject.toml se identifica como un punto de código) y se define una fuente o repositorio alternativo para obtener las dependencias, como por ejemplo:

[[tool.poetry.source]]
name = "local"
url = "<artifactory-url>"
secondary = true

o cuando se trata de Poesía (es decir, pyproject.toml que contiene una sección build-system con build-backend igual a poetry.core.masonry.api es un punto de liberación identificado) entonces puede ser necesario proporcionar credenciales para autenticarse en los registros privados.

Autenticación con repositorios privados en IBM Cloud

Es necesario proporcionar credenciales para este repositorio de fuentes ' local '. La documentación de Poetry sobre la configuración para las credenciales indica que las variables de entorno para proporcionar el usuario y la contraseña http deben ser ' POETRY_HTTP_BASIC_LOCAL_USERNAME y ' POETRY_HTTP_BASIC_LOCAL_PASSWORD.

Utilice la función de inyección de variables de entorno y añada las siguientes propiedades de entorno de canalización:

• ENV_GLOBAL_POETRY_HTTP_BASIC_LOCAL_USERNAME (texto) con el valor apropiado
• ENV_GLOBAL_POETRY_HTTP_BASIC_LOCAL_PASSWORD (asegurado) con el valor asegurado apropiado

Configurar Maven para archivos de configuración personalizados en IBM Cloud

Si tu proyecto Maven define un archivo de configuración específico con un nombre de archivo personalizado, como ' ci-settings.xml, define una propiedad de entorno de canalización maven-user-settings-file-path con el valor establecido a ' ci_settings.xml en las propiedades PR, CI pipeline, o trigger level.

Además, si hay algún ' env.<VARIABLE> ' que resolver como:

    <server>
      <username>${env.MAVEN_USERNAME}</username>
      <password>${env.MAVEN_PASSWORD}</password>
      <id>central</id>
    </server>

Utilice la función de inyección de variables de entorno para proporcionar estas variables mediante la adición de 2 propiedades de canalización (en la canalización PR y CI):

• ENV_GLOBAL_MAVEN_USERNAME (texto) con el valor a utilizar para maven username
• ENV_GLOBAL_MAVEN_PASSWORD (asegurado) con el valor a utilizar para la contraseña de maven

Activar la vinculación estática para Go Builds

Por defecto, ' go build ' produce un binario enlazado dinámicamente. Para utilizarlo en un contenedor Docker, active la vinculación estática estableciendo ' CGO_ENABLED=0 ' durante la compilación.

Configurar la variable de entorno para la compilación Go

Para habilitar la vinculación estática, utilice la función de inyección de variables de entorno para añadir la siguiente propiedad de entorno de canalización en la canalización de CI:

• ENV_SETUP_CGO_ENABLED " con el valor " 0"