Aperçu Je suis ravi d'annoncer la sortie de testcontainers-iris-node, une bibliothèque Node.js qui facilite le lancement de conteneurs InterSystems IRIS temporaires pour l'intégration et les tests E2E. Ce projet vient naturellement compléter la gamme existante d'adaptateurs Testcontainers pour IRIS, notamment testcontainers-iris-python et testcontainers-iris-java.
Pourquoi testcontainers-iris-node? En tant que développeur Node.js travaillant avec InterSystems IRIS, j'ai souvent été confronté à des difficultés lors de la configuration d'environnements de test imitant la production. testcontainers-iris-node résout ce problème en exploitant le framework testcontainers-node pour créer des environnements IRIS isolés à la demande.
Ceci est particulièrement important pour:
- Les tests d'intégration avec les bases de données IRIS
- Les tests de pipelines de données ou de microservices
- L'automatisation des environnements de test dans les pipelines CI
Fonctionnalités
- Lancement d'IRIS dans des conteneurs Docker à l'aide de Testcontainers
- Prise en charge des images et de la configuration Docker personnalisées
- Stratégies d'attente pour s'assurer qu'IRIS est prêt avant le début des tests
- Désinstallation de nettoyage entre les exécutions de tests
Pour commencer
npm install testcontainers-iris --save-devExemple d'utilisation
import { IRISContainer } from"testcontainers-iris";
import { createConnection } from"@intersystems/intersystems-iris-native";
const IMAGE = "containers.intersystems.com/intersystems/iris-community:latest-preview";
const container = awaitnew IRISContainer(IMAGE).start();
const connection = createConnection(container.getConnectionOptions());
const iris = connection.createIris();
const version = iris.classMethodString("%SYSTEM.Version", "GetNumber");
Fonctionnement En interne, la bibliothèque étend GenericContainer à partir de testcontainers, ajoute des stratégies d'attente spécifiques à IRIS et fournit des méthodes auxiliaires pour la génération de chaînes de connexion et le remplacement des configurations.
Scénarios pris en charge
- Suites de tests basées sur Jest ou Mocha
- Environments CI (GitHub Actions, GitLab CI, Jenkins, etc.)
- Développement et débogage locaux
Exemple de tests basées sur Mocha Vous pouvez également utiliser cette bibliothèque pour des tests d'intégration robustes avec Mocha. Voici un exemple de configuration:
test-setup.ts
import"source-map-support/register"import"reflect-metadata"import { IRISContainer, StartedIRISContainer } from"testcontainers-iris"import { IRISNative } from"../../src"import chai from"chai"import sinonChai from"sinon-chai"import chaiAsPromised from"chai-as-promised"
declare global {
var container: StartedIRISContainer | undefinedvar connectionOptions: {
host: string
port: number
user: string
pwd: string
ns: string
}
}
process.env.TZ = "UTC"
chai.should()
chai.use(sinonChai)
chai.use(chaiAsPromised)
before(async () => {
console.log("Setting up test environment...")
const image = process.env["IRIS_IMAGE"]
let connectionOptions = {
host: "localhost",
port: 1972,
user: "_SYSTEM",
pwd: "SYS",
ns: "USER",
}
if (image) {
const container: StartedIRISContainer = awaitnew IRISContainer(image)
.withNamespace("TEST")
.start()
console.log(IRIS container started at <span class="hljs-subst">${container.getConnectionUri()}</span>)
global.container = container
connectionOptions = {
host: container.getHost(),
port: container.getMappedPort(1972),
user: container.getUsername(),
pwd: container.getPassword(),
ns: container.getNamespace(),
}
}
global.connectionOptions = connectionOptions
IRISNative.createConnection({ ...connectionOptions, sharedmemory: false })
})
after(async () => {
console.log("Cleaning up test environment...")
if (global.container) {
await global.container.stop()
}
delete global.container
})
Cas de test:
import { IRISNative, IRISConnection } from"../src/IRISNative"
describe("IRISNative test", () => {
let connection: IRISConnection
before(() => {
const connectionOptions = global.connectionOptions
connection = IRISNative.createConnection({ ...connectionOptions })
})
after(() => {
if (connection) {
connection.close()
}
})
it("should work", async () => {
const res = await connection.query(
"SELECT 1 AS test1, '2' AS test2",
[],
)
res.rows.should.be.an("array")
res.rows.should.have.lengthOf(1)
res.rows[0].should.be.an("object")
res.rows[0].should.have.property("test1")
res.rows[0].should.have.property("test2")
res.rows[0].should.have.property("test1", 1)
res.rows[0].should.have.property("test2", "2")
})
})Utilisation dans typeorm-iris Cette bibliothèque est également utilisée dans mon projet typeorm-iris qui fournit une prise en charge expérimentale de TypeORM pour InterSystems IRIS. testcontainers-iris-node alimente la configuration des tests d'intégration pour ce projet, aidant à valider la fonctionnalité ORM par rapport à des instances IRIS réelles.
Problèmes liés à l'adoption de la bibliothèque En tant que développeur chargé de l'adoption de la bibliothèque, l'un de mes plus grands défis consiste à tester plusieurs versions d'InterSystems IRIS. Cet outil simplifie considérablement ce processus en permettant de basculer facilement et d'automatiser des environnements conteneurisés avec des versions IRIS différentes.
Comparaison avec d'autres liaisons linguistiques Alors que testcontainers-iris-python et testcontainers-iris-java sont matures et prennent en charge des fonctionnalités avancées telles que les montages en bind et les scripts de démarrage personnalisés, la variante Node.js est rationalisée pour les environnements JavaScript/TypeScript et vise la simplicité et l'ergonomie pour les développeurs.
Contributions et commentaires Je suis ouvert à tous commentaires, problèmes et demandes de modification via GitHub: testcontainers-iris-node.
Pour concluretestcontainers-iris-node facilite la réalisation de tests automatisés et robustes des applications basées sur IRIS dans l'écosystème Node.js. Que vous développiez des API, des tâches ETL ou des services d'intégration, cet outil vous aide à garantir la fiabilité de vos flux de travail IRIS.
templates) pour utiliser un modèle afin de tester les API REST :
) et sélectionnez le nom et le dossier de votre choix :
) pour exécuter notre premier test :
)
templates) pour utiliser un modèle afin de tester les requêtes JDBC :
) et stockez votre projet dans n'importe quel dossier et fichier :
).
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
Accédons d'abord à la base de données MySQL. Si vous consultez le fichier docker-compose.yml vous verrez que le nom d'utilisateur et le mot de passe définis pour MySQL et PostgreSQL sont les mêmes: testuser/testpassword.png)
Les trois tables se trouvent dans notre base de données Test, regardons notre base de données PostgreSQL:.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
.png)
