Instill Core offers the capability to disseminate your creations either via a share link or by setting them to public visibility. This allows other users to view your pipeline.
#Share Pipeline via API
Please refer to the Pipeline Object
and Update Pipeline pages.
Users can utilize the sharing
field to manage pipeline visibility, including
publishing, unpublishing, or sharing a link. This structure also
enables more fine-grained permission control in the future.
#Publish
When a user publishes the pipeline, all logged-in users can see it on the Explore page.
{ "sharing": { "users": { "*/*": { "enabled": true, "role": "ROLE_EXECUTOR" } } }}
#Unpublish
When a user unpublishes the pipeline, it becomes private and will not appear on the Explore page.
{ "sharing": { "users": { "*/*": { "enabled": false, "role": "ROLE_EXECUTOR" } } }}
#Sharing Link
When a user shares the pipeline via a link, the pipeline returns a code
. Users
can use this code in the URL path to access the pipeline:
https://instill.tech/test/pipelines/sample-pipeline/playground?view={code}
.
{ "sharing": { "shareCode": { "user": "*/*", "role": "ROLE_EXECUTOR", "enabled": true, "code": "a-share-code" // response-only } }}
#Share Pipeline via Console
Follow the steps below to share your pipeline:
- Access sharing settings: Click the
Share
button, also positioned in the top-right corner. - Sharing link:
- To distribute via a link, press
Copy Link
to copy the pipeline's URL to your clipboard.
- To distribute via a link, press
- Publish the pipeline:
- To transition a private pipeline to public visibility, press the
Publish
tab at the top of the pop-up window, followed by thePublish
button once more.
- To transition a private pipeline to public visibility, press the
- Unpublish the pipeline:
- You can also revert a public pipeline back to private status by following
similar steps as for publishing but now pressing the
Unpublish
button. This ensures your pipeline is returned to private visibility.
- You can also revert a public pipeline back to private status by following
similar steps as for publishing but now pressing the