You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: _posts/2023-05-11-RPG-CICD-Setting-up-local-development.markdown
+48-12
Original file line number
Diff line number
Diff line change
@@ -4,33 +4,69 @@ title: "RPG CiCd - Part 2 - Local Development Setup"
4
4
date: 2023-05-14 20:18:07 -0500
5
5
categories: VSCode IBM i Setup SSH
6
6
---
7
-
There are a few hurdles to overcome to achieve local rpgle / clle development. This blog post will help you though those hurdles.
7
+
8
+
## LOCAL IBM i development setup
9
+
10
+
There are a few hurdles to overcome to achieve local rpgle / clle development. This blog post will help you though those hurdles. The outcome is that changes you make on your local PC pushed to an IFS directory and compiled, while also being synchronized with online source/version control, such as Github, Bitbucket, Gitlab, etc.
11
+
12
+
> To start, we will work on the IBM i development partition where source will be built.
8
13
9
14
### You need a home directory
15
+
10
16
You need to have a home directory on your development IBM i partition. It doesn't matter how you add it, there are several ways. If we assume you can't SSH, you can always do it with a CRTDIR command in the greenscreen.
11
17
12
18

13
19
14
20
### Set default shell to Bash
21
+
15
22
If you haven't done it yet, follow instructions in [this link](https://ibmi-oss-docs.readthedocs.io/en/latest/troubleshooting/SETTING_BASH.html) to set Bash as your default shell. For historical reasons, IBM i has ksh (kornshell) as the default shell. Most folks prefer Bash. Most open source examples you find on the web use Bash. The absolute easiest way to do it is to run the following command in ACS Run SQL Scripts tool:
Go to the [Visual Studio Code download page] and install it on your machine. Once installed, it will notify you when there are updates and prompt you to update it, quite seamlessly. It usually only takes a few seconds.
24
-
2. Install extensions to VSCODE
25
-
There are a multitude of extensions available for VSCODE. They are available to install in the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/VSCode), or you can access the same marketplace from within the VSCODE in the extensions sidebar view:
28
+
> The next few steps will be done on your local PC. Windows steps are pictured, but the process isn't any different on a Mac.
29
+
30
+
### VSCODE and Git setup
31
+
32
+
#### Install VSCODE
33
+
34
+
Go to the [Visual Studio Code download page] and install it on your machine. Once installed, it will notify you when there are updates and prompt you to update it, quite seamlessly. It usually only takes a few seconds.
35
+
36
+
#### Install GIT (local)
37
+
38
+
VSCODE automatically prompts you to download and install it the first time you click on the the **source control** view in the activity bar. After GIT install and reload of VSCODE, you should see the **Open Folder** and **Clone Repository** buttons in the **source control** view.
There are a multitude of extensions available for VSCODE. They are available to install in the [Visual Studio Code Marketplace](https://marketplace.visualstudio.com/VSCode), or you can access the same marketplace from within the VSCODE in the extensions sidebar view:
26
47

27
48
28
-
Here are the most essential ones.
29
-
*[IBM i Development Pack](https://marketplace.visualstudio.com/items?itemName=HalcyonTechLtd.ibm-i-development-pack) This will install 13 extesions, all helpfull for developming on IBM i, including the Code for IBM i extension.
30
-
*[GitLense](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) This gives you full visibility to your git repository, both locally and remote.
31
-
3. Log in to your IBM i with the Code for IBM i extension.
32
-
4.[Configure your Settings](/_posts/2023-05-18-VSCODE-Settings-for-IBM-i-development.markdown)
33
-
5. Set your deploy IFS target directory
49
+
Here are the essential ones for IBM i development.
50
+
51
+
*[IBM i Development Pack](https://marketplace.visualstudio.com/items?itemName=HalcyonTechLtd.ibm-i-development-pack) This will install 13 extesions, all helpfull for developming on IBM i, including the Code for IBM i extension.
52
+
53
+
*[GitLense](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens) This gives you full visibility to your git repository, both locally and remote.
54
+
55
+
4. Log in to your IBM i with the Code for IBM i extension.
56
+
57
+
5.[Configure your Settings](/_posts/2023-05-18-VSCODE-Settings-for-IBM-i-development.markdown)
58
+
59
+
### Create a project
60
+
61
+
There are two approaches to getting a project to sync to online source control. The easiest approach is to create a blank project online, then clone it locally. In this tutorial, we will use gitlab, but the same concept applies if you are using Github, Bitbucket, and the like.
62
+
63
+
1. Log into your Gitlab account and create a new project. Think of a good name for your project. This will end up being the directory name where the source is stored. For this tutorial we will call it "My First IBM i Project".
0 commit comments