The SAP LeanIX agent discovers self-built software in self-hosted GitHub Enterprise setups and communicates this information to an SAP LeanIX workspace.
- Docker: The agent is distributed as a Docker image. Docker is required to run it.
- GitHub Enterprise Server: The agent interacts with GitHub Enterprise Server. You need access to a GitHub Enterprise Server instance.
- GitHub App: The agent operates as a GitHub App. You need to create a GitHub App in your GitHub Enterprise Server instance.
-
Create a GitHub App: Create a new GitHub App in your GitHub Enterprise Server instance. For details, refer to the GitHub documentation.
-
Generate a private key: In your GitHub App settings, generate a private key. For instructions, refer to the GitHub documentation. The agent will use the downloaded PEM file to authenticate with the GitHub Enterprise environment.
-
Install the GitHub App: Install the app on all organizations that the agent should access. For instructions, refer to the GitHub documentation.
-
Configure the agent: The agent requires the following environment variables to run. Pass them to the Docker command when starting the agent.
GITHUB_ENTERPRISE_BASE_URL: The base URL of your GitHub Enterprise Server instance.GITHUB_APP_ID: The ID of your GitHub App.PEM_FILE: The path to your GitHub App's PEM file inside the Docker container.MANIFEST_FILE_DIRECTORY: The directory path where the manifest files are stored in each repository. Manifest files are crucial for microservice discovery as they provide essential information about the service. For more information, see Microservice Discovery Through a Manifest File in our documentation. If both .yaml and .yml files exist in a repository, only the .yaml file will be used.WEBHOOK_SECRET: The secret used to validate incoming webhook events from GitHub. (Optional, but recommended. Needs to be set in the GitHub App settings first.)
-
Start the agent: To start the agent, run the following Docker command. Replace the variables in angle brackets with your actual values.
docker run -p 8000:8080 \ -v $(pwd)/path/to/your/privateKey.pem:/privateKey.pem \ -e GITHUB_ENTERPRISE_BASE_URL=<github_enterprise_base_url> \ -e GITHUB_APP_ID=<github_app_id> \ -e PEM_FILE=/privateKey.pem \ -e MANIFEST_FILE_DIRECTORY=<manifest_file_directory> \ -e WEBHOOK_SECRET=<webhook_secret> \ leanix-github-agent
This command starts the agent and exposes it on port 8000. The agent starts scanning your organizations and repositories.
Note: The Docker image for the agent is currently unavailable. It will become available for download once a new version is released. Please check the Releases page for updates.
We welcome your feedback, feature suggestions, and bug reports via GitHub issues.
We encourage contributions to this project. For details on how to contribute, the project structure, and other related information, refer to Contributing.
If you discover a potential security issue, follow our Security Policy for reporting. Please do not create GitHub issues for security-related matters.
We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone. By participating in this project, you agree to abide by its Code of Conduct at all times.
Copyright 2024 SAP SE or an SAP affiliate company and leanix-github-agent contributors. Please see our LICENSE for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available via the REUSE tool.