Set up Talend
Configure access to your Talend project repository stored in GitHub or Atlassian Stash (Bitbucket Server). The Talend connector reads project metadata directly from your version-controlled repository.
Prerequisites
Before you begin, make sure you have:
- A GitHub repository URL (or Atlassian Stash/Bitbucket Server URL) where your Talend projects are stored
- Network access to GitHub or your Stash server
- Atlan connector permissions to create and configure connectors
Create personal access token
Create a personal access token with read permissions to your Talend project repository.
- GitHub
- Atlassian Stash (Bitbucket Server)
- Log in to GitHub.
- Navigate to Settings > Developer settings > Personal access tokens > Tokens (classic).
- Click Generate new token > Generate new token (classic).
- Configure the token:
- Note: Enter a descriptive name, for example
Atlan Talend Connector - Expiration: Select an appropriate expiration period
- Scopes: Select
repofor private repositories orpublic_repofor public repositories
- Note: Enter a descriptive name, for example
- Click Generate token.
- Copy the generated token immediately—you can't view it again after leaving the page.
- Log in to your Stash instance.
- Navigate to Profile > Manage account > Personal access tokens.
- Click Create a token.
- Configure the token:
- Token name: Enter a descriptive name, for example
Atlan Talend Connector - Expiration date: Select an appropriate expiration period (optional)
- Permissions: Select Read for both Project permissions and Repository permissions
- Token name: Enter a descriptive name, for example
- Click Create.
- Copy the generated token immediately—you can't view it again after leaving the page.
Verify repository structure
Confirm your repository contains the Talend project structure exported from Talend Studio. The connector requires .item and .properties files to extract metadata.
Expected repository structure
repository/
├── process/
│ ├── folder1/
│ │ ├── job1_0.1.item
│ │ ├── job1_0.1.properties
│ │ └── job2_0.1.item
│ └── folder2/
│ └── job3_0.1.item
├── code/
│ └── routines/
├── metadata/
└── talend.project
Next steps
Crawl Talend assets: Create the workflow and run the crawl to extract Talend metadata