This section walks you through accessing and using the Artifact Manager within Jupyter Hub to explore and manage project artifacts seamlessly. Please refer to the link for more information on Artifact Manager.
Pre-requisites
Before proceeding, ensure the following:
- You are registered with FABRIC. For more information, please refer to this link.
- You have joined a project within FABRIC. If not, see this link for instructions.
- Your Jupyter Hub environment is configured. If it isn’t, refer to this link for setup details.
Explore Artifacts
Log in to Jupyter Hub
Begin by logging into Jupyter Hub with your credentials. Select the Bleeding Edge container option and click Start. For more information please refer to this link.
Navigate to the Examples Directory
- Once logged in, locate the
jupyter-examples-*
directory in your file navigator on Jupyter Hub. - Open the Start Here notebook within this directory. This will guide you to the resources and documentation needed to explore FABRIC’s features.
Open the Artifact Manager
- Inside the Start Here notebook, find and click on the Explore Artifacts notebook. This specific notebook allows you to browse, filter, and download artifacts linked to your project or available publicly on FABRIC.
Exploring Available Artifacts
- Run the initial cell within the Explore Artifacts notebook to populate a list of artifacts. This list includes:
- Public Artifacts: Artifacts available for all users.
- Project-Specific Artifacts: Artifacts exclusive to your project.
Filtering and Selecting Artifacts
- Use the built-in filters to narrow down the artifacts based on specific criteria like name, tag, or project.
- For each artifact, you’ll see all available versions listed. Review the versions to identify the one that best suits your needs.
Downloading Artifacts
- Once you’ve identified the artifact and version you wish to use, click Download. The selected artifact will automatically download to your work directory, located at
/home/fabric/work
.
- After the download completes, navigate to this directory to start using the artifact within your environment.
With the artifact downloaded and accessible in your work directory, you can now integrate it into your workflow. For further exploration or updates, revisit the Explore Artifacts notebook to stay up-to-date with new additions.
Managing Artifacts via Fablib API
In addition to exploring and downloading artifacts, you can also create, upload, or delete artifacts within the FABRIC environment using the Fablib API.
Log in to Jupyter Hub
Begin by logging into Jupyter Hub with your FABRIC credentials as described in the section above.
Navigate to the Examples Directory
- Once logged in, locate the
Jupyter-examples-*
directory in your file navigator. - Open the Start Here notebook in this directory, which provides an overview and navigation for the available resources on FABRIC.
Access the Manage Artifacts Notebook
- Inside the Start Here notebook, find and click on the Manage Artifacts notebook. This notebook is specifically designed to help you manage artifacts using the Fablib API.
Using the Fablib API for Artifact Management
- The Manage Artifacts notebook includes detailed instructions and examples for managing artifacts via the Fablib API. With these commands, you can:
- Create New Artifacts: Generate and register new artifacts within your project.Upload Artifacts: Add files or resources as artifacts to make them available for other users in your project.Delete Artifacts: Remove outdated or unnecessary artifacts from your project.
Please refer to the documentation here for more details.