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
This is a basic template for a development environment to work with ObjectScript in InterSystems IRIS. It helps you edit, compile, commit/push, debug and test your ObjectScript code. It also aids in packaging your application as a module installable with IPM.
7
+
This is a basic template for a development environment to work with ObjectScript in InterSystems IRIS. It helps you edit, compile, commit/push, debug and test your ObjectScript code. It also aids in packaging your application as a module installable with IPM.
8
8
The template is embedded python compatible.
9
9
10
10
## Description
11
11
This repository provides a ready-to-go development environment for coding productively with InterSystems ObjectScript. This template:
12
12
* Runs InterSystems IRIS Community Edition in a docker container
13
13
* Creates a new namespace and database IRISAPP
14
-
* Loads the ObjectScript code into IRISAPP database using Package Manager
14
+
* Loads the ObjectScript code into IRISAPP database using Package Manager
15
15
* Promotes development with the 'Package First' paradigm. [Watch the video](https://www.youtube.com/watch?v=havPyPbUj1I)
16
16
* Provides a unit testing environment: sample unit tests, tests module enablement
17
17
* Ready for embedded python development: ENV varialbes are set up, CallIn service is On, all modules in requirements.txt will be installed during docker build.
@@ -23,16 +23,16 @@ Once you clone the new repo to your laptop and open VSCode (with the [InterSyste
23
23
## Prerequisites
24
24
Make sure you have [git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git) and [Docker desktop](https://www.docker.com/products/docker-desktop) installed.
Open the terminal in this directory and call the command to build and run InterSystems IRIS in container:
35
-
*Note: Users running containers on a Linux CLI, should use "docker compose" instead of "docker-compose"*
34
+
Open the terminal in this directory and call the command to build and run InterSystems IRIS in container:
35
+
*Note: Users running containers on a Linux CLI, should use "docker compose" instead of "docker-compose"*
36
36
*See [Install the Compose plugin](https://docs.docker.com/compose/install/linux/)*
37
37
38
38
@@ -164,8 +164,8 @@ In case of test errors, you can find more details back in the UnitTest portal, w
164
164
165
165
### .github folder
166
166
167
-
Contains two GitHub actions workflows:
168
-
1.`github-registry.yml`
167
+
Contains two GitHub actions workflows:
168
+
1.`github-registry.yml`
169
169
Once changes pushed to the repo, the action builds the docker image on Github side and pushes the image to Github registry that can be very convenient to further cloud deployement, e.g. kubernetes.
170
170
2.`objectscript-qaulity.yml`
171
171
with every push to master or main branch the workflow launches the repo test on objectscript issues with Objectscript Quality tool, [see the examples](https://community.objectscriptquality.com/projects?sort=-analysis_date). This works if the repo is open-source only.
@@ -216,3 +216,16 @@ It describes what is loaded with the method, how it is being tested and what app
216
216
217
217
[Read about all the files in this artilce](https://community.intersystems.com/post/dockerfile-and-friends-or-how-run-and-collaborate-objectscript-projects-intersystems-iris)
218
218
219
+
220
+
221
+
## Troubleshooting
222
+
223
+
If you have issues with docker image building here are some recipes that could help.
224
+
225
+
1. You are out of free space in docker. You can expand the amount of space or clean up maually via docker desktop. Or you can call the following line to clean up:
226
+
```
227
+
docker system prune -f
228
+
```
229
+
230
+
2. We use multi-stage image building which in some cases doesn't work. Switch the target to builder from final in the docker compose and try again.
0 commit comments