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: README.md
+64Lines changed: 64 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -833,6 +833,70 @@ complete.
833
833
834
834
See the **Timeouts** section above.
835
835
836
+
Development with Devcontainer
837
+
------------------------------
838
+
839
+
This project includes a devcontainer configuration that provides a complete development environment with Oracle Database and all necessary dependencies pre-configured. The devcontainer supports both x64 and ARM64 architectures.
840
+
841
+
### Prerequisites
842
+
843
+
- [Docker](https://www.docker.com/get-started) installed and running
844
+
- [VS Code](https://code.visualstudio.com/) with the [Dev Containers extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
3. When prompted, click "Reopen in Container" or use the Command Palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) and select "Dev Containers: Reopen in Container"
860
+
861
+
4. VS Code will build and start the development environment automatically. This includes:
862
+
- Ruby 3.4
863
+
- Oracle Database Free
864
+
- Oracle Instant Client 23.8
865
+
- All required gems installed via `bundle install`
866
+
867
+
### What's Included
868
+
869
+
The devcontainer provides:
870
+
871
+
- **Ruby**: 3.4
872
+
- **Oracle Database**: Oracle Database Free (23c)
873
+
- **Oracle Instant Client**: Version 23.8
874
+
- **Database Configuration**:
875
+
- Database: `FREEPDB1`
876
+
- System password: `Oracle18`
877
+
- TNS configuration in `ci/network/admin`
878
+
879
+
### Database Access
880
+
881
+
The Oracle database is automatically started and configured with:
882
+
- Port: `1521`(forwarded from container)
883
+
- Service Name: `FREEPDB1`
884
+
- System Password: `Oracle18`
885
+
- Test users are created automatically from `spec/support/create_oracle_enhanced_users.sql`
886
+
887
+
888
+
### Running Tests
889
+
890
+
Once the devcontainer is running, you can run tests directly:
Copy file name to clipboardExpand all lines: RUNNING_TESTS.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -110,3 +110,7 @@ If no Oracle database with SYS and SYSTEM user access is available, try the dock
110
110
```sh
111
111
bundle exec rake spec
112
112
```
113
+
114
+
# Troubleshooting
115
+
116
+
If you observe strange errors when running tests, make sure the activerecord version loaded by the tests is the expected one for the oracle_enhanced version.
0 commit comments