../CHANGELOG.md
70 | 71 | 72 |
68 |
69 |
73 | ../CHANGELOG.md
70 | 71 | 72 |Singularity Compose is an orchestration tool for Singularity instances.
72 |Contents:
73 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """Build or rebuild containers
86 |
87 | Containers are built once and then named as <project>_<service>,
88 | e.g. `folder_db`. If a Singularity recipe changes for a container folder,
89 | you can run "singularity-compose build" to rebuild it.
90 | """
91 | # Initialize the project
92 | project = Project(
93 | filename=args.file, name=args.project_name, env_file=args.env_file
94 | )
95 |
96 | # Builds any containers into folders
97 | project.build(args.names)
98 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """View or validate a configuration file
86 |
87 | This comes down to reading in the config to the project, at which
88 | case it is validated. We then print it for the user.
89 | """
90 | # Initialize the project
91 | project = Project(
92 | filename=args.file, name=args.project_name, env_file=args.env_file
93 | )
94 |
95 | # Builds any containers into folders
96 | project.view_config()
97 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """create one or more instances. If they don't exist, build first.
86 |
87 | This will build and bring up one or more named instances, or if None
88 | are provided, we create all of them.
89 | """
90 | # Initialize the project
91 | project = Project(
92 | filename=args.file, name=args.project_name, env_file=args.env_file
93 | )
94 |
95 | # Create instances, and if none specified, create all
96 | project.create(
97 | args.names,
98 | writable_tmpfs=not args.read_only,
99 | bridge=args.bridge,
100 | no_resolv=args.no_resolv,
101 | )
102 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """bring one or more instances down"""
86 | # Initialize the project
87 | project = Project(
88 | filename=args.file, name=args.project_name, env_file=args.env_file
89 | )
90 |
91 | # Create instances, and if none specified, create all
92 | project.down(args.names, args.timeout)
93 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """execute a command to an instance."""
86 | # Initialize the project
87 | project = Project(
88 | filename=args.file, name=args.project_name, env_file=args.env_file
89 | )
90 |
91 | project.execute(args.name[0], extra)
92 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """bring one or more instances down"""
86 | # Initialize the project
87 | project = Project(
88 | filename=args.file, name=args.project_name, env_file=args.env_file
89 | )
90 |
91 | if args.clear:
92 | project.clear_logs(args.names)
93 | else:
94 | project.logs(args.names, args.tail)
95 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """bring one or more instances down"""
86 | # Initialize the project
87 | project = Project(
88 | filename=args.file, name=args.project_name, env_file=args.env_file
89 | )
90 |
91 | # Create instances, and if none specified, create all
92 | project.ps()
93 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 |
79 | """
80 |
81 | from scompose.project import Project
82 |
83 |
84 | [docs]def main(args, parser, extra):
85 | """bring up one or more instances. They must exist.
86 |
87 | This will build and bring up one or more named instances, or if None
88 | are provided, we create all of them.
89 | """
90 | # Initialize the project
91 | project = Project(
92 | filename=args.file, name=args.project_name, env_file=args.env_file
93 | )
94 |
95 | # Create instances, and if none specified, create all
96 | project.down(args.names)
97 |
98 | # Create instances, and if none specified, create all
99 | project.up(
100 | args.names,
101 | writable_tmpfs=not args.read_only,
102 | bridge=args.bridge,
103 | no_resolv=args.no_resolv,
104 | )
105 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 | """
79 |
80 | from scompose.project import Project
81 |
82 |
83 | [docs]def main(args, parser, extra):
84 | """bring one or more instances down"""
85 | # Initialize the project
86 | project = Project(
87 | filename=args.file, name=args.project_name, env_file=args.env_file
88 | )
89 |
90 | # Create instances, and if none specified, create all
91 | project.shell(args.name[0])
92 |
70 | """
71 |
72 | Copyright (C) 2019-2021 Vanessa Sochat.
73 |
74 | This Source Code Form is subject to the terms of the
75 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
76 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
77 |
78 | """
79 |
80 | from scompose.project import Project
81 |
82 |
83 | [docs]def main(args, parser, extra):
84 | """bring up one or more instances. They must exist.
85 |
86 | This will build and bring up one or more named instances, or if None
87 | are provided, we create all of them.
88 | """
89 | # Initialize the project
90 | project = Project(
91 | filename=args.file, name=args.project_name, env_file=args.env_file
92 | )
93 |
94 | # Create instances, and if none specified, create all
95 | project.up(
96 | args.names,
97 | writable_tmpfs=not args.read_only,
98 | bridge=args.bridge,
99 | no_resolv=args.no_resolv,
100 | )
101 |
69 | """
70 |
71 | Copyright (C) 2019-2021 Vanessa Sochat.
72 |
73 | This Source Code Form is subject to the terms of the
74 | Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed
75 | with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
76 |
77 | """
78 |
79 | from scompose.logger import bot
80 | from scompose.utils import get_installdir
81 |
82 | import os
83 |
84 |
85 | [docs]def get_template(name):
86 | """get a template by name from this directory. If does not exist,
87 | return None.
88 | """
89 | here = get_installdir()
90 | template = os.path.join(here, "templates", name)
91 | if os.path.exists(template):
92 | return template
93 | bot.warning("%s does not exist." % template)
94 |