Blackbird is the new automation backbone for the language technology industry. Blackbird provides enterprise-scale automation and orchestration with a simple no-code/low-code platform. Blackbird enables ambitious organizations to identify, vet and automate as many processes as possible. Not just localization workflows, but any business and IT process. This repository represents an application that is deployable on Blackbird and usable inside the workflow editor.
GitLab is a developer platform that allows developers to create, store, and manage their code. This app focuses on connecting repository events and file actions into the Blackbird ecosystem.
Before you can connect you need to make sure that:
- You have a GitLab account.
- You have owner permissions on the repository you want to automate on.
GitLab supports the following connection types in Blackbird:
- OAuth: use this option for GitLab-hosted accounts.
- OAuth Self-managed: use this option for self-managed GitLab instances hosted on a custom domain.
- Personal Access Token: use this option when you want to connect with a personal token instead of OAuth.
- Navigate to apps and search for GitLab. If you cannot find GitLab then click Add App in the top right corner, select GitLab and add the app to your Blackbird environment.
- Click Add Connection.
- Name your connection for future reference e.g. 'My GitLab connection'.
- Choose the connection type that matches your GitLab environment.
- Complete the authentication flow for the selected connection type.
- When you return to Blackbird, confirm that the connection has appeared and the status is Connected.
- Create a new GitLab connection in Blackbird.
- Select OAuth as the connection type.
- Click Authorize connection.
- Follow the GitLab authorization flow and approve the requested access.
- Return to Blackbird and confirm that the connection status is Connected.
If your GitLab instance is hosted on a custom domain, use the OAuth Self-managed connection type in Blackbird.
- In your self-managed GitLab instance, navigate to Admin area -> Applications and click Add new application.
- Enter an application name, for example Blackbird Self-Managed Test.
- Set Redirect URI to
https://bridge.blackbird.io/api/AuthorizationCode. - Save the application and copy the generated Application ID and Secret.
- In Blackbird, create a new GitLab connection and choose OAuth Self-managed as the connection type.
- Enter your GitLab instance URL as Base URL, for example
https://yourdomain.example.com. - Paste the GitLab Application ID into Client ID and the GitLab Secret into Client secret.
- Click Authorize connection and complete the OAuth consent flow in your self-managed GitLab instance.
- Return to Blackbird and confirm that the connection has appeared and the status is Connected.
- Create a personal access token with the scopes required for the actions you want to use.
- In Blackbird, create a new GitLab connection and choose Personal Access Token as the connection type.
- Paste the token into the API key field.
- Save the connection and confirm that the status is Connected.
- Create new repository Create repository with selected settings.
Advanced settings:
- User ID: User ID that owns the created repository.
- Default branch: Default branch name for the created repository.
- Namespace ID: Namespace ID for the created repository.
- Description: Repository description.
- Enable issues: Option to enable issues.
- Enable merge requests: Option to enable merge requests.
- Enable jobs: Option to enable jobs.
- Enable wiki: Option to enable wiki.
- Enable snippets: Option to enable snippets.
- Enable container registry: Option to enable the container registry.
- Enable shared runners: Option to enable shared runners.
- Visibility: Repository visibility.
- Import URL: URL to import repository content from.
- Public jobs: Option to make jobs public.
- Only allow merge if pipeline succeeds: Option to allow merges only after a successful pipeline.
- Only allow merge if all discussions are resolved: Option to allow merges only after all discussions are resolved.
- Enable LFS: Option to enable large file storage.
- Enable request access: Option to allow users to request access.
- Tags: Multiple tags to assign to the repository.
- Enable printing merge request link: Option to print merge request links.
- CI config path: CI config file path.
- Initialize with README: Option to create an initial README file.
- Download file Download a file from a repository by file path.
Advanced settings:
- Branch name: Branch to use instead of the default branch.
- Get all files in folder Get files from a repository folder.
Advanced settings:
- Folder path (e.g. "Folder1/Folder2"): Folder path to get files from.
- Include subfolders: Option to include files in nested folders.
- Get repository Get repository details.
- Search repository issues Get open issues in a repository.
- Search repository merge requests Get open merge requests in a repository.
- Search repository folder content Search folder content in a repository.
Advanced settings:
- Content type: Content type to include.
- Search repositories Search repositories available to connection.
- Search files by filepaths Get files from a repository by file paths.
- Check if branch exists Check whether branch exists in a repository.
- Search commits Search commits in a repository.
Advanced settings:
- Authors to include: Multiple author names or emails to include.
- Authors to exclude: Multiple author names or emails to exclude.
- Commit after: Only commits after this date.
- Commit before: Only commits before this date.
- Commit message contains: Text that commit message must contain.
- File path: Only commits touching this file path.
- Find commit Find first commit that matches search filters in a repository.
- Get commit Get commit details by commit ID.
- List added or modified files in X hours Search files added or modified during specified number of hours.
Advanced settings:
- Path pattern: Use forward slash '/' to represent directory separator. Use '*' to represent wildcards in file and directory names. Use '**' to represent arbitrary directory depth.
- Upload file Create file or update existing file in a repository.
- Update file Update existing file in a repository.
- Delete file Delete file from a repository.
- Search merge requests Search merge requests in a repository.
- Get merge request Get merge request details.
- Create merge request Create merge request.
- Complete merge request Complete merge request by merging it.
Advanced settings:
- Merge commit message: Text for the merge commit message.
- Search branches Search repository branches.
- Get branch Get branch details by name.
- Create branch Create branch from a base branch.
- On commit pushed On commit pushed to a repository branch.
- On files added On files added by new commits. Outputs paths to added files.
- On files modified On files modified by new commits. Outputs paths to modified files.
- On files added or modified On files added or modified by new commits. Outputs paths to added or modified files.
- On files removed On files removed by new commits. Outputs paths to removed files.
For the file specific events, a path parameter can be specified in order to narrow down the event to only files in specific folders or files that have certain extensions. Use the forward slash '/' to represent directory separator. Use '*' to represent wildcards in file and directory names. Use '**' to represent arbitrary directory depth.
For example: when you want to create an event that triggers only when .html files are modified in a folder called locales. Then the path pattern should be: /locales/*.html
The following bird creates a new memoQ project whenever files are updated or added to a specific folder in a GitLab repository.
Do you want to use this app or do you have feedback on our implementation? Reach out to us using the established channels or create an issue.