-
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
f39cfae
commit 23818b3
Showing
5 changed files
with
287 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| ## [<img src="https://cdn.worldvectorlogo.com/logos/teamcity.svg" height="20" align="center"/>](https://www.jetbrains.com/teamcity/) docker images | ||
|
|
||
| [<img src="http://jb.gg/badges/official.svg" height="20"/>](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub) | ||
|
|
||
| ### Minimal agent (jetbrains/teamcity-minimal-agent) | ||
|
|
||
| [](https://hub.docker.com/r/jetbrains/teamcity-minimal-agent/) | ||
|
|
||
| This minimal image adds just a TeamCity agent without any tools like VCS clients, etc. It is suitable for simple builds and can serve as a base for your custom images. | ||
|
|
||
| - [Repo](https://hub.docker.com/r/jetbrains/teamcity-minimal-agent) | ||
| - [Details](context/generated/teamcity-minimal-agent.md) | ||
| - [How to use](dockerhub/teamcity-minimal-agent/README.md) | ||
|
|
||
| ### Agent (jetbrains/teamcity-agent) | ||
|
|
||
| [](https://hub.docker.com/r/jetbrains/teamcity-agent/) | ||
|
|
||
| This image adds a TeamCity agent suitable for Java and .NET development. | ||
|
|
||
| - [Repo](https://hub.docker.com/r/jetbrains/teamcity-agent) | ||
| - [Details](context/generated/teamcity-agent.md) | ||
| - [How to use](dockerhub/teamcity-agent/README.md) | ||
|
|
||
| ### Server (jetbrains/teamcity-server) | ||
|
|
||
| [](https://hub.docker.com/r/jetbrains/teamcity-server/) | ||
|
|
||
| - [Repo](https://hub.docker.com/r/jetbrains/teamcity-server) | ||
| - [Details](context/generated/teamcity-server.md) | ||
| - [How to use](dockerhub/teamcity-server/README.md) | ||
|
|
||
| ### Build images locally | ||
|
|
||
| - Ensure [Docker](https://www.docker.com/get-started) installed. | ||
| - Clone this repository. | ||
| - Download the required TeamCity [_.tar.gz_ file](https://www.jetbrains.com/teamcity/download/#section=section-get). For instance ```wget -c https://download.jetbrains.com/teamcity/TeamCity-2020.1.tar.gz -O - | tar -xz -C context``` | ||
| - Unpack this file into the directory [context/TeamCity](context/TeamCity) within the cloned repository. | ||
| - Apply required changes in the directory [configs](configs). | ||
| - Generate docker and readme files by running the _generate.sh_ or _generate.cmd_ script. All generated artifacts will be placed into the directory [generated](generated). | ||
| - Run docker build commands like [on this page](generated/teamcity-agent.md) keeping the proposed order from the root directory of the cloned repository. The proposed order is important because some TeamCity images may be based on other TeamCity images. | ||
| - Check the docker images by running ```docker-compose up``` in the directories like [checks/windows-local](checks/windows-local) or [checks/linux-local](checks/linux-local). |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,115 @@ | ||
| ## TeamCity Server - Powerful Continuous Integration and Continuous Delivery out of the box | ||
|
|
||
| [<img src="http://jb.gg/badges/official.svg" height="20"/>](https://confluence.jetbrains.com/display/ALL/JetBrains+on+GitHub) | ||
|
|
||
| This is an official [JetBrains TeamCity](https://www.jetbrains.com/teamcity/) server image. The image is suitable for production use and evaluation purposes. | ||
|
|
||
| <img src="https://raw.githubusercontent.com/JetBrains/teamcity-docker-images/master/logo/GitHub.png" height="20" align="center"/> More details about tags and components are [here](https://github.com/JetBrains/teamcity-docker-images/blob/master/generated/teamcity-server.md). | ||
|
|
||
| ## How to Use This Image | ||
|
|
||
| First, pull the image from the Docker Hub Repository | ||
|
|
||
| ```docker pull jetbrains/teamcity-server``` | ||
|
|
||
|
|
||
| ### Linux container | ||
|
|
||
| Use the following command to start a container with TeamCity server | ||
|
|
||
|
|
||
|
|
||
| ``` | ||
| docker run -it --name teamcity-server-instance \ | ||
| -v <path-to-data-directory>:/data/teamcity_server/datadir \ | ||
| -v <path-to-logs-directory>:/opt/teamcity/logs \ | ||
| -p <port-on-host>:8111 \ | ||
| jetbrains/teamcity-server | ||
| ``` | ||
| where | ||
|
|
||
| - **\<path-to-data-directory>** is the host machine directory to serve as the [TeamCity Data Directory](https://www.jetbrains.com/help/teamcity/teamcity-data-directory.html) where TeamCity stores project settings and build results. Pass an empty directory for the brand new start. If the mapping is not set, you will lose all the TeamCity settings on the container shutdown. | ||
| - **\<path-to-logs-directory>** is the host machine directory to store the TeamCity server logs. The mapping can be omitted, but then the logs will be lost on container shutdown which will make issues investigation impossible. | ||
|
|
||
|
|
||
| If you need to run a Linux-based container with non-root permissions (for example, when using some open source container application platforms), set the server's internal user identifier explicitly by passing an additional `-u 1000:1000` parameter. Note that after switching to a non-root user you might not be able to perform writing operations on files created under the root user. In this case, run `chown -R 1000:1000 <directory>` to change the ownership of the directory containing these files. | ||
|
|
||
| #### Alternative Tomcat configuration | ||
|
|
||
| TeamCity has Tomcat J2EE server under the hood, and if you need to provide an alternative configuration for the TomCat, you can use extra parameter | ||
| ``` | ||
| -v /alternative/path/to/conf:/opt/teamcity/conf | ||
| ``` | ||
|
|
||
| To get a sample of the current contents of the Tomcat's `conf` directory, use the [`docker cp`](https://docs.docker.com/engine/reference/commandline/cp/) command. | ||
|
|
||
| ### Windows container | ||
| ``` | ||
| docker run -it --name teamcity-server-instance | ||
| -v <path-to-data-directory>:C:/ProgramData/JetBrains/TeamCity | ||
| -v <path-to-logs-directory>:C:/TeamCity/logs | ||
| -p <port-on-host>:8111 | ||
| jetbrains/teamcity-server | ||
| ``` | ||
|
|
||
| See above for **\<path-to-data-directory>** and **\<path-to-logs-directory>** description. | ||
|
|
||
| The details on the known problems in Windows containers are available in the [TeamCity documentation](https://www.jetbrains.com/help/teamcity/known-issues.html#KnownIssues-WindowsDockerContainers). | ||
|
|
||
| ### Database | ||
|
|
||
| TeamCity stores set of users and build results in an SQL database in addition to the Data Directory. | ||
| By default, the TeamCity server uses an internal database stored on the file system under the data directory. However, production use requires an [external database](https://www.jetbrains.com/help/teamcity/setting-up-an-external-database.html#SettingupanExternalDatabase-DefaultInternalDatabase). | ||
|
|
||
| To use the server for production, make sure to review and apply the [recommendations](https://www.jetbrains.com/help/teamcity/installing-and-configuring-the-teamcity-server.html#InstallingandConfiguringtheTeamCityServer-ConfiguringServerforProductionUse). | ||
|
|
||
| ### Build agents | ||
|
|
||
| You will need at least one TeamCity agent to run builds. Check the [`jetbrains/teamcity-agent`](https://hub.docker.com/r/jetbrains/teamcity-agent/) and [`jetbrains/teamcity-minimal-agent`](https://hub.docker.com/r/jetbrains/teamcity-minimal-agent/) images. | ||
|
|
||
| ## Additional Commands | ||
|
|
||
| When you need to pass additional environment variables to the server process, use the regular `-e` option. For example, to pass TEAMCITY_SERVER_MEM_OPTS environment variable, use: | ||
|
|
||
| ``` | ||
| docker run -it --name teamcity-server-instance \ | ||
| -e TEAMCITY_SERVER_MEM_OPTS="-Xmx2g -XX:MaxPermSize=270m -XX:ReservedCodeCacheSize=350m" \ | ||
| -v <path-to-data-directory>:/data/teamcity_server/datadir \ | ||
| -v <path-to-log-directory>:/opt/teamcity/logs \ | ||
| -p <port-on-host>:8111 \ | ||
| jetbrains/teamcity-server | ||
| ``` | ||
| | ||
| To run the `maintainDB` script (e.g. for the server backup), stop your running container and execute the following command from your host: | ||
| ``` | ||
| docker run -it --name teamcity-server-instance \ | ||
| -v <path-to-data-directory>:/data/teamcity_server/datadir \ | ||
| -v <path-to-log-directory>:/opt/teamcity/logs \ | ||
| -p <port-on-host>:8111 \ | ||
| jetbrains/teamcity-server \ | ||
| "/opt/teamcity/bin/maintainDB.sh" "backup" | ||
| ``` | ||
| | ||
|
|
||
| Be sure to keep all the local system paths the same with the main server start command. | ||
|
|
||
| To change the context of the TeamCity app inside a Tomcat container, pass `-e TEAMCITY_CONTEXT=/context` to the `docker run` command. The default one is `ROOT`, meaning that the server would be available at `http://host/`. | ||
|
|
||
| ## Upgrading TeamCity | ||
|
|
||
| Make sure to check the generic TeamCity [upgrade instructions](https://www.jetbrains.com/help/teamcity/upgrade.html). | ||
| If you made no changes to the container, you can just stop the running container, pull a newer version of the image and the server in it via the usual command. | ||
| If you changed the image, you will need to replicate the changes to the new TeamCity server image. In general, use Docker common sense to perform the upgrade. | ||
|
|
||
| ## License | ||
|
|
||
| The image is available under the [TeamCity license](https://www.jetbrains.com/teamcity/buy/license.html). | ||
| TeamCity is free for perpetual use with the limitation of 100 build configurations (jobs) and 3 agents. [Licensing details](https://www.jetbrains.com/help/teamcity/licensing-policy.html). | ||
|
|
||
| ## Feedback | ||
|
|
||
| Report issues of suggestions to the official TeamCity [issue tracker](https://youtrack.jetbrains.com/issues/TW). | ||
|
|
||
| ## Other TeamCity Images | ||
| * [Minimal Build Agent](https://hub.docker.com/r/jetbrains/teamcity-minimal-agent/) | ||
| * [Build Agent](https://hub.docker.com/r/jetbrains/teamcity-agent/) |
Oops, something went wrong.