Skip to content

Commit

Permalink
Merge pull request #1 from zoomin-software/Laura-Zoomin-patch-1
Browse files Browse the repository at this point in the history
Update README.md
  • Loading branch information
yoorita authored Oct 15, 2024
2 parents e68b379 + 605f39e commit c59c8ae
Showing 1 changed file with 24 additions and 60 deletions.
84 changes: 24 additions & 60 deletions README.md
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).

0 comments on commit c59c8ae

Please sign in to comment.