--- parser: v2 auto_validation: true primary_tag: products>sap-btp--abap-environment tags: [ tutorial>beginner, programming-tool>abap-development, software-product>sap-business-technology-platform, tutorial>license] time: 15 author_name: Niloofar Flothkoetter author_profile: https://github.com/niloofar-flothkoetter slug: abap-environment-abapgit canonical_url: https://developers.sap.com/tutorials/abap-environment-abapgit --- # Use abapGit to Transfer Your On-Premise ABAP Source Code to the Cloud Transfer Your ABAP Source Code from your on-premise SAP system to your SAP Business Technology Platform ABAP Environment instance over a Github Repository using the abapGit report and the ADT plugin for abapGit. ## Prerequisites - `github.com` or similar account - SAP BTP ABAP Environment system and user with developer role - on-premise system with user and required root CA of Git server (STRUST) - Download Eclipse Photon or Oxygen and install ABAP Development Tools (ADT). See . - For More information see [Working with `abapGit`](https://help.sap.com/viewer/65de2977205c403bbc107264b8eccf4b/Cloud/en-US/d62ed9d54a764c53990f25f0ab6c27f9.html) ## You will learn - How to create content in an on-premise system and push it to Git repository - How to import the content from Git repository into a SAP BTP ABAP Environment instance --- ### Create a Git repository 1. Log in to your `github.com` account. 2. Create a new repository by clicking on **New** button. ![new repository](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/github1.png) 3. Enter a name and description and choose **Private**, check the checkbox **Add a README file** under **Initialize this repository with:** and click **Create repository**. ![create repository](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/github2.png) 4. Our repository is all set up for now. ![create repository](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/github3.png) ### Install and set up abapGit As next you need to install `abapGit` on your on-premise system. >**IMPORTANT** Arrange with your system administrator before you install `zabapgit`. 1. Copy the content of the latest build from the program `zabapgit`, that you will find in the `abapGit` repository . ![latest build](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/github4.png) 2. Open your on-premise system of your choice and create a new program like **`ZABAPGIT_STANDALONE`** via SE38 and paste the saved content into it. Activate and execute the program. ![create](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit16.png) <<<<<<< HEAD 3. If you have installed `abapGit` before, you need to go to SE38, search for **ZABAPGIT_STANDALONE** program and press **Execute**. ======= 3. If you have installed `abapGit` before, you need to go to SE38, search for **`ZABAPGIT_STANDALONE`** program and press **Execute**. >>>>>>> 59f95048a11e62962d5c8eb49e89b6f027533a25 ![search program](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit1.png) 4. Now `abapGit` is installed and opened. ![execute program](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit2.png) >You can find all installation information under > **Documentation/Guides**. > **IMPORTANT** Logon with language `EN` to your on-premise system. SAP BTP ABAP Environment just supports `EN` at the moment. Otherwise you'll get issues during import. ### Push ABAP source from on-premise to Git repository 1. Back to your created repository and click **Code** and copy the URL of your repository. ![clone](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit3.png) 2. Go to transaction `ZABAPGIT_STANDALONE` and press the **New Online**. ![add online](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit4.png) 3. Paste the repository URL and click **Create Package**. ![repository URL](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit5.png) 4. Enter a name and a **Short Description**. The **Software Component** should be **LOCAL**. You do not need a **Super package**. Click **Continue** icon. ![continue](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit6.png) 5. In the new popup click **Create Request** icon on the left hand side of **Own Requests**, to create a new transport request. ![new request](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit17.png) 6. Enter a **Short Description** and click the **Save** icon. ![save](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit18.png) 7. Click **Continue** icon. ![create package](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit7.png) 8. Now you have a new package and you can see your created package. Click **Clone Online Repository**. ![ABAPGIT](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit19.png) 6. You will see the cloned Git repository in **Repository List**. ![ABAPGIT](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit8.png) ### Add ABAP development objects 1. Open your on-premise system in ADT and add your created Package in the last step by right click in the **Favorite Packages**. ![favorite](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit20.png) 2. Add ABAP development objects to your package, for example an ABAP class. Save and activate your changes. ![development objects](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit9.png) >Not supported ABAP object types will be ignored during import. ### Stage and commit developed objects 1. Go back to the `abapGit` UI and click **Refresh** to see all developments objects that you created in ADT. ![refresh](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit10.png) 2. Press **Stage**. ![stage](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit11.png) 3. Select single objects to add or **Add all and commit**. ![add all](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit12.png) 4. Enter **committer name**, **committer e-mail** and a **comment** and press **Commit**. ![commit](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit13.png) 5. You will be prompted with a credentials popup. Enter your Git repository server credentials and click **Execute**. ![enter credentials](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit14.png) 6. After everything went well, you can see the pushed ABAP objects in your Git repository. ![repository updated](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/abapgit15.png) ### Install abapGit Eclipse plugin 1. In ADT choose in the menu bar **Help** > **Install New Software**. ![eclipse](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/eclipse1.png) 2. Add the URL `http://eclipse.abapgit.org/updatesite/`and press enter to display the available features. Select **`abapGit`** **for ABAP Development Tools (ADT)** and install the plugin. ![enter URL](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/eclipse2.png) ### Open abapGit repositories 1. Select your cloud project system in the **Project Explorer** in ADT and open the `abapGit` repositories view by opening **Window** > **Show View** > **Other ...**. ![repository](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/eclipse6.png) 2. Expand the category **ABAP** and select **`abapGit Repositories`** and click **Open** ![expand ABAP](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/eclipse7.png) ### Clone Git repository into SAP BTP ABAP Environment 1. Click the clone button (green + button) in the `abapGit` repositories view. ![clone button](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/clone1.png) 2. Enter your `Git` repository URL and press **Next**. ![enter repository](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/clone2.png) 3. Select **Branch** and a **Package**, where your Git repository should be cloned. (If you have no packages, you need to create a new one before) and click **Next**. ![choose package](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/clone3.png) 4. Select a transport request and click **Finish**. ![finish](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/clone4.png) 6. Open **`abapGit` Repositories** tab, right-click your package and click **pull**. It takes some minutes to pull successfully. ![finish](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/pull.png) 5. Your imported sources are now available under your package. ![end](https://raw.githubusercontent.com/sap-tutorials/abap-core-development/main/tutorials/abap-environment-abapgit/clone5.png) ### Test yourself ---