Saagie projects

Use these tutorials to create and modify a Saagie project.

1. Create a Saagie project

This section should not be necessary - you can ignore it except if the project Dunder Mifflin Paper Sales does not already exist on the platform.

Together, let’s create the project Dunder Mifflin Paper Sales.

Let’s assume that:

  • you are logged in to Saagie, and

  • you have the right to create a project.

1.1. Navigate to projects and begin creating project

Start by navigating to the projects interface.

  1. Navigate to the platform on which you’d like to create your project. Note that you might only have access to one platform.

  2. Locate the primary navigation panel, which includes links to all the modules you can access.

  3. Go to the Projects module.

  4. Now that you’re in the right module, select the New Project button.

Navigate to Projects

1.2. Enter project name and description

  1. Enter the name of your project: Dunder Mifflin Paper Sales

  2. Enter a description of your project: This is a sample project for learning purposes.

  3. Select the Continue button.

Enter name and description for project

1.3. Choose project technologies

Next, choose the technologies you’ll need for this project. You need to choose one or more technologies for each job category.

  1. In the Extraction category, select the Bash, Java/Scala, Python, and Spark checkboxes.

    Make sure to select your technologies from the correct repository. In this image, we use technologies from the repository Dunder Mifflin - URL for each job category.

  2. In the Processing category, select the Java/Scala, Python, and Spark checkboxes.

  3. In the Smart Apps category, select the Generic checkbox.

  4. Select the Continue button.

Choose technologies for project

1.4. Manage authorizations

The last step is to decide who has rights to this project, as well as the scope of those rights.

  1. First, notice that there is a section listing groups who can access all projects. Manage groups that have access to all projects in the Security module.

  2. Next, add access rights for any groups you’d like. In this image, we grant access to the group dunder-mifflin.

    Choose authorizations for project part one

  3. Choose the role viewer for the group dunder-mifflin.

    Refer to the groups explanation section to review the authorizations for each role.

  4. If the group was added by mistake, remove it by selecting the minus sign icon next to the roles for that group.

  5. Select the Create project button.

    Choose authorizations for project part two

After selecting the Create project button, you’ll see something like this on your screen:

Project initialization

It might take a few minutes for the project to be created. Perhaps it’s time for a quick coffee break?

2. Modify a project

Together, we’re going to modify the project Dunder Mifflin Paper Sales.

Let’s assume that you’ve completed the tutorial Create a Saagie project where you created the project Dunder Mifflin Paper Sales.

2.1. Navigate to project

Start by navigating to the example project.

  1. Go to the Projects module from the primary navigation menu.

  2. Go to the Dunder Mifflin Paper Sales project.

    Navigate to your project

2.2. Update settings

You can edit all settings for your project.

  1. Go to Project settings.

    You can access a project’s settings from the homepage of any of the following: jobs, pipelines, apps, environment variables, and Docker credentials.
Navigate to project settings

2.2.1. Name and description

Going to project settings opens a page with three tabs. The first tab—​where you can modify a project’s name and description—​opens automatically.

  1. Leave the name of your project as is.

  2. Add No sensitive data should be used in this project. to the description of your project.

    Enter name and description for project

2.3. Technologies

Next, let’s update your technologies.

After creating your project, you realized that you do not need the technology Java/Scala for Extraction jobs. You do, however, need R for Processing jobs.

  1. Go to the Job Technologies tab.

  2. In the Extraction section, clear the Java/Scala checkbox.

    Make sure you’re choosing technologies from the correct repository.

  3. In the Processing section, select the R checkbox.

  4. Make no changes in the Smart Apps section.

    Modify project technologies

2.4. Authorizations

Finally, you can modify authorizations.

When creating the project, we assigned the role of viewer to the group dunder-mifflin. You’ve realized, however, that dunder-mifflin needs the role of editor.

Refer to the groups explanation section to review the authorizations for each role.

  1. Go to the Authorizations tab.

  2. Choose the role of editor for the group dunder-mifflin

  3. Select the Save settings button.

    Modify project authorizations

Excellent! You have now created and modified a Saagie project.