diff --git a/Testcontainers.sln b/Testcontainers.sln
index aacb19742..ab57c46bb 100644
--- a/Testcontainers.sln
+++ b/Testcontainers.sln
@@ -1,4 +1,4 @@
-Microsoft Visual Studio Solution File, Format Version 12.00
+Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.0.31903.59
MinimumVisualStudioVersion = 10.0.40219.1
@@ -191,6 +191,10 @@ Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Testcontainers.Tests", "tes
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Testcontainers.WebDriver.Tests", "tests\Testcontainers.WebDriver.Tests\Testcontainers.WebDriver.Tests.csproj", "{EBA72C3B-57D5-43FF-A5B4-3D55B3B6D4C2}"
EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Testcontainers.Gitlab", "src\Testcontainers.Gitlab\Testcontainers.Gitlab.csproj", "{B3857615-7DD1-41D2-BA74-938DA4469E5E}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Testcontainers.Gitlab.Tests", "tests\Testcontainers.Gitlab.Tests\Testcontainers.Gitlab.Tests.csproj", "{185C65BB-0F79-40D0-A940-7CBE7C8E6A30}"
+EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
@@ -556,6 +560,14 @@ Global
{EBA72C3B-57D5-43FF-A5B4-3D55B3B6D4C2}.Debug|Any CPU.Build.0 = Debug|Any CPU
{EBA72C3B-57D5-43FF-A5B4-3D55B3B6D4C2}.Release|Any CPU.ActiveCfg = Release|Any CPU
{EBA72C3B-57D5-43FF-A5B4-3D55B3B6D4C2}.Release|Any CPU.Build.0 = Release|Any CPU
+ {B3857615-7DD1-41D2-BA74-938DA4469E5E}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {B3857615-7DD1-41D2-BA74-938DA4469E5E}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {B3857615-7DD1-41D2-BA74-938DA4469E5E}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {B3857615-7DD1-41D2-BA74-938DA4469E5E}.Release|Any CPU.Build.0 = Release|Any CPU
+ {185C65BB-0F79-40D0-A940-7CBE7C8E6A30}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+ {185C65BB-0F79-40D0-A940-7CBE7C8E6A30}.Debug|Any CPU.Build.0 = Debug|Any CPU
+ {185C65BB-0F79-40D0-A940-7CBE7C8E6A30}.Release|Any CPU.ActiveCfg = Release|Any CPU
+ {185C65BB-0F79-40D0-A940-7CBE7C8E6A30}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(NestedProjects) = preSolution
{5365F780-0E6C-41F0-B1B9-7DC34368F80C} = {673F23AE-7694-4BB9-ABD4-136D6C13634E}
@@ -647,5 +659,7 @@ Global
{9E8E6AA5-65D1-498F-BEAB-BA34723A0050} = {7164F1FB-7F24-444A-ACD2-2C329C2B3CCF}
{27CDB869-A150-4593-958F-6F26E5391E7C} = {7164F1FB-7F24-444A-ACD2-2C329C2B3CCF}
{EBA72C3B-57D5-43FF-A5B4-3D55B3B6D4C2} = {7164F1FB-7F24-444A-ACD2-2C329C2B3CCF}
+ {B3857615-7DD1-41D2-BA74-938DA4469E5E} = {673F23AE-7694-4BB9-ABD4-136D6C13634E}
+ {185C65BB-0F79-40D0-A940-7CBE7C8E6A30} = {7164F1FB-7F24-444A-ACD2-2C329C2B3CCF}
EndGlobalSection
EndGlobal
diff --git a/src/Testcontainers.Gitlab/.editorconfig b/src/Testcontainers.Gitlab/.editorconfig
new file mode 100644
index 000000000..6f066619d
--- /dev/null
+++ b/src/Testcontainers.Gitlab/.editorconfig
@@ -0,0 +1 @@
+root = true
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/GitlabBuilder.cs b/src/Testcontainers.Gitlab/GitlabBuilder.cs
new file mode 100644
index 000000000..571d75df6
--- /dev/null
+++ b/src/Testcontainers.Gitlab/GitlabBuilder.cs
@@ -0,0 +1,89 @@
+namespace Testcontainers.Gitlab;
+
+///
+[PublicAPI]
+public sealed class GitlabBuilder : ContainerBuilder
+{
+ ///
+ /// This is the default image for gitlab community edition in version 16.11.1 .
+ ///
+ public const string GitlabImage = "gitlab/gitlab-ce:16.11.1-ce.0";
+ ///
+ /// This port is used for http communication to gitlab instance.
+ ///
+
+ public const ushort GitlabHttpPort = 80;
+ ///
+ /// This port is used for ssh communication to gitlab instance.
+ ///
+ public const ushort GitlabSshPort = 22;
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ public GitlabBuilder()
+ : this(new GitlabConfiguration())
+ {
+ DockerResourceConfiguration = Init().DockerResourceConfiguration;
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The Docker resource configuration.
+ private GitlabBuilder(GitlabConfiguration resourceConfiguration)
+ : base(resourceConfiguration)
+ {
+ DockerResourceConfiguration = resourceConfiguration;
+ }
+
+ ///
+ protected override GitlabConfiguration DockerResourceConfiguration { get; }
+
+ ///
+ public override GitlabContainer Build()
+ {
+ Validate();
+ return new GitlabContainer(DockerResourceConfiguration);
+ }
+
+ ///
+ protected override GitlabBuilder Init()
+ {
+ return base.Init()
+ .WithImage(GitlabImage)
+ .WithPortBinding(GitlabHttpPort, true)
+ .WithPortBinding(GitlabSshPort, true)
+ .WithEnvironment("GITLAB_ROOT_PASSWORD", DockerResourceConfiguration.Password)
+ .WithWaitStrategy(Wait.ForUnixContainer()
+ .UntilPortIsAvailable(80)
+ .UntilPortIsAvailable(22)
+ .UntilContainerIsHealthy()
+ .UntilHttpRequestIsSucceeded(request => request.ForPath("/users/sign_in").ForStatusCode(HttpStatusCode.OK)));
+ }
+
+ ///
+ /// Sets the Gitlab password.
+ ///
+ /// The Gitlab password.
+ /// A configured instance of .
+ public GitlabBuilder WithPassword(string password)
+ {
+ return Merge(DockerResourceConfiguration, new GitlabConfiguration(password: password));
+ }
+
+ ///
+ protected override void Validate() => base.Validate();
+
+ ///
+ protected override GitlabBuilder Clone(IResourceConfiguration resourceConfiguration)
+ => Merge(DockerResourceConfiguration, new GitlabConfiguration(resourceConfiguration));
+
+ ///
+ protected override GitlabBuilder Clone(IContainerConfiguration resourceConfiguration)
+ => Merge(DockerResourceConfiguration, new GitlabConfiguration(resourceConfiguration));
+
+ ///
+ protected override GitlabBuilder Merge(GitlabConfiguration oldValue, GitlabConfiguration newValue)
+ => new(new GitlabConfiguration(oldValue, newValue));
+}
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/GitlabConfiguration.cs b/src/Testcontainers.Gitlab/GitlabConfiguration.cs
new file mode 100644
index 000000000..12accd51b
--- /dev/null
+++ b/src/Testcontainers.Gitlab/GitlabConfiguration.cs
@@ -0,0 +1,71 @@
+namespace Testcontainers.Gitlab;
+
+///
+[PublicAPI]
+public sealed class GitlabConfiguration : ContainerConfiguration
+{
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The Gitlab admin password.
+ public GitlabConfiguration(string password)
+ {
+ _password = password;
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ public GitlabConfiguration()
+ {
+ _password = Guid.NewGuid().ToString();
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The Docker resource configuration.
+ public GitlabConfiguration(IResourceConfiguration resourceConfiguration)
+ : base(resourceConfiguration)
+ {
+ // Passes the configuration upwards to the base implementations to create an updated immutable copy.
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The Docker resource configuration.
+ public GitlabConfiguration(IContainerConfiguration resourceConfiguration)
+ : base(resourceConfiguration)
+ {
+ // Passes the configuration upwards to the base implementations to create an updated immutable copy.
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The Docker resource configuration.
+ public GitlabConfiguration(GitlabConfiguration resourceConfiguration)
+ : this(new GitlabConfiguration(), resourceConfiguration)
+ {
+ // Passes the configuration upwards to the base implementations to create an updated immutable copy.
+ }
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The old Docker resource configuration.
+ /// The new Docker resource configuration.
+ public GitlabConfiguration(GitlabConfiguration oldValue, GitlabConfiguration newValue)
+ : base(oldValue, newValue)
+ {
+ _password = BuildConfiguration.Combine(oldValue.Password, newValue.Password);
+ }
+
+ ///
+ /// Gets the Gitlab admin password.
+ ///
+ public string Password => _password;
+
+ private readonly string _password;
+}
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/GitlabContainer.cs b/src/Testcontainers.Gitlab/GitlabContainer.cs
new file mode 100644
index 000000000..712e0f664
--- /dev/null
+++ b/src/Testcontainers.Gitlab/GitlabContainer.cs
@@ -0,0 +1,73 @@
+using Testcontainers.Gitlab.Models;
+using Testcontainers.Gitlab.RegexPatterns;
+
+namespace Testcontainers.Gitlab;
+
+///
+///
+/// Initializes a new instance of the class.
+///
+/// The container configuration.
+[PublicAPI]
+public sealed class GitlabContainer(GitlabConfiguration configuration) : DockerContainer(configuration)
+{
+ ///
+ /// Gets the root password.
+ ///
+ public string Password => configuration.Password;
+
+
+ ///
+ /// Generate a personal access token.
+ ///
+ /// The personal access token to create.
+ ///
+ ///
+ public async Task GenerateAccessToken(PersonalAccessToken pat)
+ {
+ var scope = "[" + '\'' + pat.Scope.ToString().Replace(", ", "\', \'") + '\'' + "]";
+
+ var command = $"token = User.find_by_username('{pat.User}')" +
+ $".personal_access_tokens" +
+ $".create(name: '{pat.Name}', scopes: {scope}, expires_at: {pat.ExpirationInDays}.days.from_now); " +
+ $"puts token.cleartext_tokens";
+
+ var tokenCommand = new List{
+ { "gitlab-rails" },
+ { "runner" },
+ { command }
+ };
+
+ ExecResult tokenResult = await ExecAsync(tokenCommand);
+
+ string token;
+ if (tokenResult.ExitCode == 0)
+ {
+ var match = GitlabRegex.GitlabPersonalAccessToken.Match(tokenResult.Stdout);
+ token = match.Value;
+ }
+ else
+ {
+ throw new DataMisalignedException("Stderr: " + tokenResult.Stderr + "|" + "Stdout: " + tokenResult.Stdout);
+ }
+ pat.TokenInternal = token;
+ return pat;
+ }
+
+ ///
+ /// Generate a personal access token.
+ ///
+ /// Name of the personal access token. If left empty a GUID will be used.
+ /// The name of the user that owns this personal access token.
+ /// The scope that will be given to the token.
+ /// Days until the tokens expires.
+ ///
+ public async Task GenerateAccessToken(string user, PersonalAccessTokenScopes scope, string name = "", int expirationInDays = 365)
+ => await GenerateAccessToken(new PersonalAccessToken
+ {
+ Name = string.IsNullOrWhiteSpace(name) ? Guid.NewGuid().ToString() : name,
+ User = user,
+ Scope = scope,
+ ExpirationInDays = expirationInDays
+ });
+}
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/Models/PersonalAccessToken.cs b/src/Testcontainers.Gitlab/Models/PersonalAccessToken.cs
new file mode 100644
index 000000000..0c7d53576
--- /dev/null
+++ b/src/Testcontainers.Gitlab/Models/PersonalAccessToken.cs
@@ -0,0 +1,36 @@
+namespace Testcontainers.Gitlab.Models;
+
+///
+/// The personal access token that is used to authenticate against the API from gitlab.
+///
+public record PersonalAccessToken
+{
+ /// Name of the personal access token. If left empty a GUID will be used.
+ /// The name of the user that owns this personal access token.
+ /// The scope that will be given to the token.
+ /// Days until the tokens expires.
+ ///
+ /// Name of the personal access token. If left empty a GUID will be used.
+ ///
+ public string Name { get; set; } = string.Empty;
+ ///
+ /// The name of the user that owns this personal access token.
+ ///
+ public string User { get; set; } = string.Empty;
+ ///
+ /// The scope that will be given to the token.
+ ///
+ public PersonalAccessTokenScopes Scope { get; set; } = PersonalAccessTokenScopes.None;
+ ///
+ /// Days until the tokens expires.
+ ///
+ public int ExpirationInDays { get; set; } = 365;
+ ///
+ /// Internal token that is used to set the token publically.
+ ///
+ internal string TokenInternal { get; set; } = string.Empty;
+ ///
+ /// The token that will be generated.
+ ///
+ public string Token => TokenInternal;
+}
diff --git a/src/Testcontainers.Gitlab/Models/PersonalAccessTokenScopes.cs b/src/Testcontainers.Gitlab/Models/PersonalAccessTokenScopes.cs
new file mode 100644
index 000000000..2bf72803e
--- /dev/null
+++ b/src/Testcontainers.Gitlab/Models/PersonalAccessTokenScopes.cs
@@ -0,0 +1,18 @@
+namespace Testcontainers.Gitlab.Models
+{
+ [Flags]
+ public enum PersonalAccessTokenScopes
+ {
+ None = 0,
+ api = 2,
+ read_api = 4,
+ read_user = 8,
+ read_repository = 16,
+ write_repository = 32,
+ read_registry = 64,
+ write_registry = 128,
+ create_runner = 256,
+ ai_features = 512,
+ k8s_proxy = 1024,
+ }
+}
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/RegexPatterns/GitlabRegex.cs b/src/Testcontainers.Gitlab/RegexPatterns/GitlabRegex.cs
new file mode 100644
index 000000000..378965f8e
--- /dev/null
+++ b/src/Testcontainers.Gitlab/RegexPatterns/GitlabRegex.cs
@@ -0,0 +1,18 @@
+using System.Text.RegularExpressions;
+
+namespace Testcontainers.Gitlab.RegexPatterns;
+
+///
+/// This class contains regex patterns that are used in gitlab.
+///
+public static partial class GitlabRegex
+{
+ ///
+ /// GitLab Personal Access Token
+ ///
+ public static Regex GitlabPersonalAccessToken => new(@"glpat-[0-9a-zA-Z_\-]{20}", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+ ///
+ /// Regex Pattern to find the gitlab root password
+ ///
+ public static Regex GitlabRootPassword => new(@"Password: .*", RegexOptions.Compiled | RegexOptions.IgnoreCase);
+}
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/Testcontainers.Gitlab.csproj b/src/Testcontainers.Gitlab/Testcontainers.Gitlab.csproj
new file mode 100644
index 000000000..8b2ed72c6
--- /dev/null
+++ b/src/Testcontainers.Gitlab/Testcontainers.Gitlab.csproj
@@ -0,0 +1,12 @@
+
+
+ net6.0;net8.0;netstandard2.0;netstandard2.1
+ latest
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/src/Testcontainers.Gitlab/Usings.cs b/src/Testcontainers.Gitlab/Usings.cs
new file mode 100644
index 000000000..0e135aab0
--- /dev/null
+++ b/src/Testcontainers.Gitlab/Usings.cs
@@ -0,0 +1,15 @@
+global using System;
+global using System.Collections.Generic;
+global using System.IO;
+global using System.Net;
+global using System.Linq;
+global using System.Text;
+global using System.Threading;
+global using System.Threading.Tasks;
+global using Docker.DotNet.Models;
+global using DotNet.Testcontainers;
+global using DotNet.Testcontainers.Builders;
+global using DotNet.Testcontainers.Configurations;
+global using DotNet.Testcontainers.Containers;
+global using JetBrains.Annotations;
+global using Microsoft.Extensions.Logging;
\ No newline at end of file
diff --git a/tests/Testcontainers.Gitlab.Tests/.editorconfig b/tests/Testcontainers.Gitlab.Tests/.editorconfig
new file mode 100644
index 000000000..6f066619d
--- /dev/null
+++ b/tests/Testcontainers.Gitlab.Tests/.editorconfig
@@ -0,0 +1 @@
+root = true
\ No newline at end of file
diff --git a/tests/Testcontainers.Gitlab.Tests/GitlabContainerTests.cs b/tests/Testcontainers.Gitlab.Tests/GitlabContainerTests.cs
new file mode 100644
index 000000000..da19a02b6
--- /dev/null
+++ b/tests/Testcontainers.Gitlab.Tests/GitlabContainerTests.cs
@@ -0,0 +1,33 @@
+using Testcontainers.Gitlab.Models;
+using System.Net.Http;
+
+namespace Testcontainers.Gitlab;
+
+public sealed class GitlabContainerTest : IAsyncLifetime
+{
+ private readonly GitlabContainer _gitlabContainer = new GitlabBuilder().Build();
+
+ public Task InitializeAsync()
+ {
+ return _gitlabContainer.StartAsync();
+ }
+
+ public Task DisposeAsync()
+ {
+ return _gitlabContainer.DisposeAsync().AsTask();
+ }
+
+ [Fact]
+ [Trait(nameof(DockerCli.DockerPlatform), nameof(DockerCli.DockerPlatform.Linux))]
+ public async Task GetUser()
+ {
+ var pat = await _gitlabContainer.GenerateAccessToken("root", PersonalAccessTokenScopes.api);
+
+ using var client = new HttpClient();
+ client.DefaultRequestHeaders.Add("PRIVATE-TOKEN", pat.Token);
+ var port = _gitlabContainer.GetMappedPublicPort(80);
+ var result = await client.GetAsync($"http://localhost:{port}/api/v4/user");
+
+ Assert.True(result.IsSuccessStatusCode);
+ }
+}
\ No newline at end of file
diff --git a/tests/Testcontainers.Gitlab.Tests/Testcontainers.Gitlab.Tests.csproj b/tests/Testcontainers.Gitlab.Tests/Testcontainers.Gitlab.Tests.csproj
new file mode 100644
index 000000000..d2907edff
--- /dev/null
+++ b/tests/Testcontainers.Gitlab.Tests/Testcontainers.Gitlab.Tests.csproj
@@ -0,0 +1,18 @@
+
+
+ net8.0
+ false
+ false
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/tests/Testcontainers.Gitlab.Tests/Usings.cs b/tests/Testcontainers.Gitlab.Tests/Usings.cs
new file mode 100644
index 000000000..02acb4398
--- /dev/null
+++ b/tests/Testcontainers.Gitlab.Tests/Usings.cs
@@ -0,0 +1,6 @@
+global using System.Data;
+global using System.Data.Common;
+global using System.Threading.Tasks;
+global using DotNet.Testcontainers.Commons;
+global using Microsoft.Data.SqlClient;
+global using Xunit;
\ No newline at end of file