Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/dynatrace/libbuildpack-dynatrace
Common resources used for Dynatrace integration in Cloudfoundry Buildpacks.
https://github.com/dynatrace/libbuildpack-dynatrace
integration
Last synced: about 21 hours ago
JSON representation
Common resources used for Dynatrace integration in Cloudfoundry Buildpacks.
- Host: GitHub
- URL: https://github.com/dynatrace/libbuildpack-dynatrace
- Owner: Dynatrace
- License: apache-2.0
- Created: 2018-11-22T09:26:39.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-10-25T08:59:49.000Z (21 days ago)
- Last Synced: 2024-10-25T10:39:59.989Z (21 days ago)
- Topics: integration
- Language: Go
- Size: 3.17 MB
- Stars: 2
- Watchers: 16
- Forks: 5
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# libbuildpack-dynatrace
Base Library for Go-based Cloud Foundry Buildpack integrations with Dynatrace.
## Summary
The library provides the `Hook` struct that implements the `libbuildpack.Hook` interface that it's requested by the CF Buildpacks.
On the buildpacks, you're expected to provide a hook through a `init()` function where you can register such hook implementation. For example, a simple implementation could be,
```go
import (
"github.com/cloudfoundry/libbuildpack"
"github.com/Dynatrace/libbuildpack-dynatrace"
)
func init() {
libbuildpack.AddHook(dynatrace.NewHook("nodejs", "process"))
}
```
## Configuration
The Hook will look for credentials in the configurations for existing services (which is represented in the runtime as the VCAP_SERVICES environment variable in JSON format.) We look for service names having the 'dynatrace' substring.
We support the following configuration fields,
| Key | Type | Description | Required | Default |
| ------------- | ------- | ------------------------------------------------------------------------------------------- | -------- | --------------- |
| environmentid | string | The ID for the Dynatrace environment. | Yes | N/A |
| apitoken | string | The API Token for the Dynatrace environment. | Yes | N/A |
| apiurl | string | Overrides the default Dynatrace API URL to connect to. | No | Default API URL |
| skiperrors | boolean | If true, the deployment doesn't fail if the Dynatrace agent download fails. | No | false |
| networkzone | string | If set, agent is configured to choose communication endpoints located at the field's value. | No | empty |
| enablefips | boolean | If true, the [FIPS 140-2 mode](https://www.dynatrace.com/news/blog/dynatrace-achieves-fips-140-2-certification/) is enabled | No | false |
| addtechnologies| string | Adds additional OneAgent code-modules via a comma-separated list. See [supported values](https://docs.dynatrace.com/docs/dynatrace-api/environment-api/deployment/oneagent/download-oneagent-version#parameters) in the "included" row | No | empty |
For example,
```bash
cf create-user-provided-service dynatrace -p '{"environmentid":"...","apitoken":"..."}'
```
See more at the documentation for [`cf create-user-provided-service`](http://cli.cloudfoundry.org/en-US/cf/create-user-provided-service.html).
We also support standard Dynatrace environment variables.
## Requirements
- Go 1.11
- Linux to run the tests.
## Development
You can download or clone the repository.
You can run tests through,
```
go test
```
If you modify/add interfaces, you may need to regenerate the mocks. For this you need [gomock](https://github.com/golang/mock):
```
# To download Gomock
go get github.com/golang/mock/gomock
go install github.com/golang/mock/mockgen
# To generate the mocks
go generate
```