GitLab

purpose gitlab integration is very similar to github's integration in its purpose installation echoes supports both the hosted version of gitlab or on premises deployments connecting to your gitlab instance echoes lets your connect to your gitlab instance either with the oauth flow or using a personal access token there are no security advantage to either method of authentication oauth will generally require less clicks and is easier to setup using a dedicated service account we recommend creating a service account on your gitlab instance and installing echoes under this account's identity it will make the echoes installation independent of the lifetime of any particular individual for example, echoes will continue working properly if the person who did the installation leaves the company it will also allow for fine grained management of the role under which echoes operates and the gitlab groups echoes is allowed to participate in permissions the gitlab integration requires the api and read user token scopes at installation time echoes will subscribe to events on your gitlab projects by registering a webhook , which requires maintainer role on the group proxying the gitlab api some customers may be concerned granting the api permissions to a third party for them, we provide a gitlab api proxy docid\ shoxeku ylfkdat7bfhst which significantly improves the security guarantees at the cost of self hosting an additional service checking for labels we distribute a reusable gitlab job you can use in your pipeline in order to check for the presence of echoes required labels diff + include https //gitlab com/echoeshq/echoes gitlab job/raw/main/echoes check yml stages \ deploy \+ echoes\ check deploy job stage deploy script \ echo "application successfully deployed " echoes checks that pull requests have at least one echoes/intent or echoes/initiative label, and optionally one echoes/effort label the "details" links has useful documentation to help communicating engineers the purpose of these labels please not that we are closely following gitlab developments for a first class checks api and will integrate with it as soon as it becomes generally available manage your installations update the personal access token a gitlab integration installed with a personal access token can be edited the edition allows updating the personal access token itself to do so, click on the "three dots" menu under actions > edit once the personal access token is entered click save editing the personal access token permits for instance to rotate the token for security reasons update the repositories within the repositories tab is the repositories editor from this editor it is possible to add or remove repositories from echoes supervision when a repository is unselected, echoes no longer listen to its events repositories update faq during the installation, why don't i see my group in the list? there are two possible reasons echoes requires you to be the maintainer of the group please make sure you are at least the maintainer of the group you are looking for by design echoes only lists the top groups therefore subgroups will not be shown in the list