-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #1 from zoomin-software/Laura-Zoomin-patch-1
Update README.md
- Loading branch information
Showing
1 changed file
with
24 additions
and
60 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,60 +1,24 @@ | ||
# 🚀 About this GitHub action | ||
|
||
## Introduction | ||
The intention is to allow Salesforce clients to publish GitHub content to Salesforce Knowledge Base. | ||
The user receives credentials when creating a GitHub connector in Salesforce. | ||
|
||
## Ingested content | ||
Zips all the files | ||
|
||
## Processed content | ||
- Markdown files | ||
- HTML files | ||
|
||
## 🤖 Works when | ||
A pull request is created. | ||
Branches: `main`, `master`. | ||
|
||
## 💡 Before using the Action | ||
Ensure that those secrets are added: | ||
|
||
1. On GitHub, navigate to the main page of the repository. | ||
2. Under your repository name, click Settings. If you cannot see the **"Settings"** tab, select the dropdown menu, then click Settings. | ||
![](https://github.com/user-attachments/assets/2dacddb0-f744-461a-a37f-b01d0d1ca476) | ||
3. In the **"Security"** section of the sidebar, select **Secrets and variables**, then click Actions. | ||
![](https://github.com/user-attachments/assets/b4ab13e7-b539-4f44-bf69-6cac3e0f9540) | ||
4. Click on **"Manage environment secrets"**. | ||
![](https://github.com/user-attachments/assets/1f2599c9-4b1f-447c-86c6-402e9b592d5c) | ||
![](https://github.com/user-attachments/assets/e4645704-4a9c-448e-9d75-3762e4211480) | ||
|
||
|
||
### 🔑 The next secrets should be added: | ||
- `AWS_KEY_ID` | ||
- `AWS_SECRET_ACCESS_KEY` | ||
- `AWS_REGION` | ||
- `AWS_BUCKET` | ||
- `AWS_FOLDER` | ||
|
||
## 💻 Usage example | ||
```yaml | ||
name: Action Name | ||
on: [push] | ||
|
||
jobs: | ||
deploy: | ||
name: Upload to Amazon S3 | ||
runs-on: ubuntu-latest | ||
# These permissions are needed to interact with GitHub's OIDC Token endpoint. | ||
permissions: | ||
id-token: write | ||
contents: read | ||
steps: | ||
- name: Github Uploader for Salesforce Unified Knowledge | ||
uses: zoomin-software/[email protected] | ||
with: | ||
aws-key-id: ${{ secrets.AWS_KEY_ID }} | ||
aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }} | ||
aws-region: ${{ secrets.AWS_REGION }} | ||
aws-bucket: ${{ secrets.AWS_BUCKET }} | ||
aws-folder: ${{ secrets.AWS_FOLDER }} | ||
``` | ||
# Salesforce Knowledge Article Connector for GitHub | ||
|
||
## About This Connector | ||
|
||
The GitHub Connector for Salesforce Unified Knowledge allows you to upload your GitHub repository supported contents to Salesforce as Knowledge Articles. | ||
Once in Salesforce, those knowledge articles can be natively viewed and searched, and grounded on by Einstein. | ||
This connector is used with the following [documentation](https://unifiedknowledge.ai/salesforce/bundle/github/page/github_markdown_as_a_unified_knowledge_source.html), so if you’re just getting started begin there. | ||
You should come to this page only when you have reached the steps [here](https://unifiedknowledge.ai/salesforce/bundle/github/page/configure_github_markdown_as_a_unified_knowledge_source.html). | ||
|
||
## Upload Process | ||
When the connector runs, a zip file of the repo contents which can be uploaded is created and the files are uploaded to Salesforce. | ||
|
||
## Supported File Types | ||
|
||
Only the following file types are supported. | ||
- Markdown | ||
- HTML | ||
|
||
## Automation Trigger | ||
|
||
The connector is automatically triggered when a pull request is created from the following branches: `main` and/or `master`. | ||
|
||
## What to Do Next? | ||
Follow the instuctions [here](https://unifiedknowledge.ai/salesforce/bundle/github/page/github_markdown_as_a_unified_knowledge_source.html). |