# Pre-work This section is broken up into the following steps: 1. [Download or Clone the Repository](#1-download-or-clone-the-repository) 2. [Create an Analytics Project and Deployment Space](#2-create-a-project-and-deployment-space) ## 1. Download or Clone the Repository Various parts of this workshop will require the attendee to upload files or run scripts that we've stored in the repository. So let's get that done early on, you'll need [`git`](https://git-scm.com) on your laptop to clone the repository directly, or access to [GitHub.com](https://github.com/) to download the zip file. To Download, go to the [GitHub repo for this workshop](https://github.com/IBM/cloudpakfordata-telco-churn-workshop) and download the archived version of the workshop and extract it on your laptop. ![download workshop zip](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2F-M0YU2pd2LZNZHAOQxfO%2F-M0YU4dbR2xn1IOxtR7G%2Fcp4d-telco-workshop-git-zip-download.png?generation=1582217092866084\&alt=media) Alternately, run the following command: ```bash git clone https://github.com/IBM/cloudpakfordata-telco-churn-workshop cd cloudpakfordata-telco-churn-workshop ``` ## 2. Create a Project and Deployment Space At this point of the workshop we will be using Cloud Pak for Data for the remaining steps. ### Log into Cloud Pak for Data Launch a browser and navigate to your Cloud Pak for Data deployment > **NOTE:** Your instructor will provide a URL and credentials to log into Cloud Pak for Data! ![Cloud Pak for Data login](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F59c52dc10fe343428692a497cd9e549cc05f9015.png?generation=1595272996632282\&alt=media) ### Create a New project In Cloud Pak for Data, we use the concept of a project to collect / organize the resources used to achieve a particular goal (resources to build a solution to a problem). Your project resources can include data, collaborators, and analytic assets like notebooks and models, etc. * Go the (☰) menu and click *Projects* ![(☰) Menu -> Projects](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fc01f89483ecad35450f6b873f7d9e6476d965cc1.png?generation=1595273053628966\&alt=media) * Click on *New project +* ![Start a new project](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F997eb4a4f9aa46b52231043d3c747f16a9222f8f.png?generation=1595273053727549\&alt=media) * Select *Analytics project* for the project type and click on *Next* ![Select project type](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F4687bedc299bb01bd8e55c6f5f652dd27b64a214.png?generation=1595273065704945\&alt=media) * We are going to create a project from an existing file (which contains assets we will use throughout this workshop), as opposed to creating an empty project. Select the *Create a project from a file* option: ![Create project from file](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F8f8836282a9f5e8665815093cdefad0e4839bc8b.png?generation=1595273059304169\&alt=media) * Navigate to where you cloned this repository, then to `projects/` and choose `Customer-Churn-Project.zip`. Give the project a name and click `Create`: ![Browse for project files](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fa46319b970c73bcbc8902b405177c109e102eb4c.png?generation=1595273020473064\&alt=media) * After succesful creation, click on *View new project* ![Import project success](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F0f65afa6afc6237902ce82c109d93fde61b37701.png?generation=1595273065982446\&alt=media) ### Create a Deployment Space Cloud Pak for Data uses the concept of `Deployment Spaces` to configure and manage the deployment of a set of related deployable assets. These assets can be data files, machine learning models, etc. * Go the (☰) menu and click `Analyze` -> `Analytics deployments`: ![(☰) Menu -> Analytics deployments](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F3f4f1164e3c45959bd394d086a99fada6ab58c15.png?generation=1595272976530891\&alt=media) * Click on `+ New deployment space`: ![Add New deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Ffb8fd040da4518ced8381ea5708b224533ed1524.png?generation=1595273047485050\&alt=media) * Select the *Create an empty space* option. ![Create empty deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F0e476825debe816fb664c92ac113e51aec52ed10.png?generation=1595273066318883\&alt=media) * Give your deployment space a unique name, optional description, then click `Create`. You will use this space later when you deploy a machine learning model. ![Create deployment space](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2Fdbbcc30d331ff4d1e4789afccd2f3977ddb02f27.png?generation=1595273065839213\&alt=media) * Next, we will add a collaborator to the new deployment space, so that assets we deploy can be monitored in the OpenScale model monitoring lab. * Click on the `Access control` tab and then click on `Add collaborators +` on the right. ![Deployment space access control](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F30859beb6649861d9f0ec6aa69c8ccf9d83f93ec.png?generation=1595273049446814\&alt=media) * Enter "admin" as a Collaborator and select the user from the drop down list. Then click on the `Add to list +` button. > **NOTE:** We are adding the user that configured the machine learning instance for OpenScale monitoring. In this case, the user is the admin user. ![Deployment space collaborators](https://2515897395-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M0YTFb_WdaBDnhlXs-q%2Fsync%2F43fade763814699b6efd52c2ee3f9cfafad671b4.png?generation=1595273045690026\&alt=media) * Click the `Add` button to finish adding the collaborator. You should be brought back to the deployment space page and see your user ID along with the `Admin` user as collaborators for this space. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://ibm-developer.gitbook.io/cloudpakfordata-telco-workshop/getting-started/pre-work.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.