Categories

Versions

You are viewing the RapidMiner Hub documentation for version 9.9 -Check here for latest version

Collaborate via Projects

The concept of aProjectwas introduced in RapidMiner 9.7.

AProjectis a shared repository with version control provided byGit.

Projects enable your team to collaborate easily and safely, because you can roll back your changes at any point in time. Under the hood, the Projects of RapidMiner AI Hub utilize a Git Server, enabling the connection to third-party tools, but no knowledge of Git is required when working with Projects.

The following sections outline how to use and manage Projects.

Create a Project

Create a Project within the RapidMiner AI Hub Web UI:

  1. On the left, in theRepositorymenu, click onProjects:

  2. TheProjectspage is displayed. On the top right, clickCreate Project.

  3. TheCreate Projectdialog opens.

    Migrating an external Git repository to RapidMiner AI Hub

    If you are creating a completely new Project, you should leaveInitialize ProjectandEnable Git LFSchecked. Enabling Git LFS reduces the impact of large files in your Project. By default,.ioo,.rmhdf5table,.collectionand.conninfofile types are tracked with LFS.

    If, on the other hand, you want to share an externally-createdGitrepository as a Project via RapidMiner AI Hub, you should:

    • leaveInitialize Projectunchecked, andCreatethe Project
    • insert theProject URLas the remote URL in the external.git/config, and executegit push

      [remote "origin"] url = http://localhost:8080/executions/git/my-project.git
    • ifGit LFSis enabled, the use of LFS in the client is highly recommended. Install LFS withgit lfs installand configure the LFS URL by runninggit config lfs.url /executions/lfs/my-project.git. Ensure that the.gitattributesfile is tracked. By default, a.lfsconfigis created during Project creation to ease this process for non RapidMiner clients.

  4. Congratulations! You have created your first Project and it will be visible on theProjectspage:

Connect to a Project

After you have created your first Project you can connect to it viaRapidMiner Studioby using the associatedProject URL.

In the same way, any external Git client can connect to the Project. For example, using theGitcommand-line interface, you can connect to the Project as follows:

git clone 

View a Project

From theProjectspage, you can browse individual Projects by clicking theViewlink next to the Project name.

Overview

TheOverviewpage displays the meta information of the Project. Depending on your privileges, you can edit the permissions or delete the entire Project.

Contents

TheContentspage allows you to browse the Project content on RapidMiner AI Hub.

  • A click on a folder will display its content.
  • A click on a file will open the details view for the specific file type.

Snapshot History

TheSnapshot Historypage displays the history of the Project. Each row in the table corresponds to aSnapshot.

To inspect a Snapshot, click on the three dots for that row and onView Snapshot. The details page lists the files and folders that have been changed in this Snapshot. You can download the whole Snapshot as a ZIP file by clickingDownload Snapshot.

编辑项目(权限)

The permissions system distinguishes between content permissions and Project permissions.

  • Permitted Users & Groupshave access to the contents of the Project. To add a user or group, select them fromAll Users & Groups, and press the right arrow.

    • 他们可以浏览Contentstab.
    • They can modify the content viaRapidMiner Studioor an external Git client.
    • Theycannotalter Project-related settings in theOverviewtab.
  • Ownerscan change the Project-related settings in theOverviewtab. To add an owner, use the search box below the list of existing owners.

    • They can modify the lists ofPermitted Users & GroupsandOwners.
    • They can delete the Project.

删除a Project

CAUTION:The delete operation is a destructive operation andCANNOTbe undone. Deleted Projects areNOTrecoverable!

Only the owners of a Project can delete a Project. To delete a Project, click删除from within theProjectspage or theOverviewpage.

To protect the Project, a confirmation dialog is displayed. To confirm that you really want to delete the Project, you must first enter the Project name, and then click删除.

Advanced Project usage and configuration

Caching Projects in Job Containers

Job Containers cache Projects and update them before every execution, to reduce download times. To control cache sizes in Job Containers, see the configuration options described underContainer caching for Projects.

Git server configuration

By default, Project data resides within theRapidMiner Server/AI Hub home directory, under

/data/repositories/git_server/

You can configure Project behavior by modifying theGitconfiguration files inside this directory.

Force-push and deletions

In new Projects, force pushes and deletions are disabled. This behavior can be changed for any Project at any time by manually editing the file

/data/repositories/git_server//config

and changing the attribute values in the[receive]section fromtruetofalse.

[receive] denyNonFastForwards = false denyDeletes = false

Sample Projects

If you like to disable automatic sample Project creation on startup, add the propertyrepositories.sample.enabledwith valuefalseto theexecution.propertiesfile within the/configurationfolder of yourRapidMiner Server/AI Hub home directory.

Hidden files

By default, files with a leading dot, such as.gitattributes, are automatically hidden in the Project content browser. You can view these hidden files using the toggle button in the Project content browser.

Upload limit

In the contents browser and the Project creation dialog and in the Project content browser, you can upload a.zipfile, so the project will be populated with its contents. The maximum file size limit of those.zipfile is 5 GB. To increase it,

If you like to change the file size limit, add the propertyrepositories.maxUploadSizewith a specific value like10240Mbto set it to 10 GB in theexecution.propertiesfile within the/configurationfolder of yourRapidMiner Server/AI Hub home directory.