Using Code Pipeline for Eclipse with GIT

It is recommended that users review the Git to Code Pipeline Integration - A Tutorial to perform the Git to Code Pipeline integrations for the complete functionality. Below is the functionality that can be performed directly from within Code Pipeline for Eclipse.

Code Pipeline actions, such as performing a build or generate, can be performed for a GIT project. In order to perform Code Pipeline actions on a GIT project, the project must be imported from GitHub or Bitbucket into Eclipse, point to a valid YAML configuration file (ispwconfig.yml), and indicate the life cycle level of the project.

Refer to the Code Pipeline to GIT Integration: Code Pipeline YAML Configuration File for information on the available Code Pipeline property settings and path mappings that can be in the ispwconfig.yml file.

To configure the GIT project for Code Pipeline support

1. From the Project Explorer view, right-click the GIT project's project node and select Configure>Configure to Use Code Pipeline. The following occurs:
   • If a YAML configuration file is not found at the root of the selected project, the Configure Code Pipeline and GIT Mapping wizard appears.
   • If a YAML configuration file is found at the root of the selected, the wizard does not appear but, behind the scenes, the project nature is set so Code Pipeline actions can be performed on the projec Skip past the Configure Code Pipeline and GIT Mapping wizard step below.
2. In the Configure Code Pipeline and GIT Mapping wizard, do one of the following to specify the YAML file to be used:

   • Select Create a new .yml file to create a new .yml file. Click Next, complete the fields, then click Finish. The YAML file is created and added to the root of the selected project in the Project Explorer view.

     Important

     Optionally, click Configure to configure a new host.

   • Select Use an existing .yml file, enter or browse to the location to use an existing YAML configuration file, then click Finish. By default, the YAML file will be copied to the root of the selected project and be renamed to ispwconfig.yml. Optionally, clear the Copy the file into the selected project check box to not copy the YAML file to the root of the project and not rename the file.

     If the GIT project contains files, path mappings are added to the YAML file based on those files. If the project does not contain files, default path mappings are added to the YAML file but may need to be revised for your site's Code Pipeline instance.
     If you configure a project to use the Code Pipeline project, SubAppl will be added automatically in ispwconfig.yml.

3. From the Project Explorer view, right-click the GIT project's project node and select Properties>Code Pipeline. The Code Pipeline page of the Properties dialog box appears. The values shown for the host and port, runtime configuration, stream, application, sub application, and assignment prefix are prepopulated based on the YAML configuration file. The level value is required to perform any Code Pipeline action and must be entered manually.

   Important

   If you need the Assignment Prefix field to display a value in the Properties dialog box, you must manually add assignmentPrefix in the YAML file and assign the required value. This is an optional field and is used for the assignment creation.

4. In the Level field, enter the life cycle level for the project (such as DEV1 or DEV2), which will be used to load the file into Code Pipeline at that level.
5. Optionally, revise any of the properties.
6. Click Apply and Close. Any property changes are updated in the YAML configuration file except for the level. The level is persisted for the project but not in the YAML configuration file.

Code Pipeline actions, such as loading files into a Code Pipeline container or performing a build or generate, can now be performed.

To load files into a Code Pipeline container

1. Ensure that the GIT project is configured for Code Pipeline.

2. From the Project Explorer view, right-click the desired GIT project files and select Code Pipeline>Load into Code Pipeline. 

   The selected files are loaded into a Code Pipeline container at the level set in the Code Pipeline properties. If the files were previously loaded at the specified level, the files are loaded to the same container, replacing the component in that container. If the files were not previously loaded at the specified level, the files are loaded to a new container. The Console view shows the container and level at which the component was loaded.

To build impacted components

1. Ensure that the GIT project is configured for Code Pipeline.
2. From the Project Explorer view, right-click the desired GIT project tasks and select Code Pipeline>Build. The files are loaded into Code Pipeline and then the build process begins.
3. See the Build topic for details on Code Pipeline's build functionality.

To generate

1. Ensure that the GIT project is configured for Code Pipeline.
2. From the Project Explorer view, right-click the desired GIT project tasks and select Code Pipeline>Generate. The files are loaded into Code Pipeline and then the generate process begins.
3. See the Generate topic for details on Code Pipeline's generate functionality.

To generate with parms

1. Ensure that the GIT project is configured for Code Pipeline.
2. From the Project Explorer view, right-click the desired GIT project tasks and select Code Pipeline>Generate with Parms. The files are loaded into Code Pipeline and then the generate process begins.
3. See the Generate topic for details on Code Pipeline's generate with parms functionality.

To generate with options

1. Ensure that the GIT project is configured for Code Pipeline.
2. From the Project Explorer view, right-click the desired GIT project tasks and select Code Pipeline>Generate with Options. The files are loaded into Code Pipeline and then the generate process begins.
3. See the Generate topic for details on Code Pipeline's generate with options functionality.