Skip to content

Commit 587de12

Browse files
sarahsimperssarahsimpers
authored
v1.15: Removes submodule and adds in files AND backports build error fixes (#523)
* Removes submodule (#464) * Adds back the command dir, test file (#465) * Adds command files * (DOCSP-41222) Resolves quickstart build warnings (#447) * (DOCSP-41222) Resolves quickstart build warnings * Changes ephemeral cluster page
1 parent aed5ac4 commit 587de12

File tree

431 files changed

+38984
-16
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

431 files changed

+38984
-16
lines changed

‎.gitmodules

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +0,0 @@
1-
[submodule "submodules/mongodb-atlas-cli"]
2-
path = submodules/mongodb-atlas-cli
3-
url = https://github.com/mongodb/mongodb-atlas-cli.git

‎source/atlas-cli-changelog.txt

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ Released 20 July 2023
222222
- Fixes issue with the printed table format for the
223223
:ref:`atlas-networking-containers-list` command.
224224
- Removes support for MongoDB 4.2.
225-
- Configures :ref:`atlas-quickstart` command as an alias for the
225+
- Configures ``atlas quickstart`` command as an alias for the
226226
:ref:`atlas-setup` command.
227227
- Fixes the :ref:`atlas-backups-restores-watch` command output format.
228228
- Fixes the :ref:`atlas-backups-restores-watch` command to work
@@ -263,7 +263,7 @@ Released 29 June 2023
263263
- :ref:`atlas-dataFederation-queryLimits`
264264

265265
- Adds the ``--tag`` flag to the :ref:`atlas-setup` and
266-
:ref:`atlas-quickstart` commands.
266+
``atlas quickstart`` commands.
267267
- Updates a namespace to be optional for performance advisor operations.
268268
- Fixes the :ref:`atlas-clusters-update` and :ref:`atlas-serverless-update`
269269
commands ignoring the ``--tag`` flag.
@@ -688,7 +688,7 @@ Released 16 June 2022
688688
with the {+atlas-cli+} <install-atlas-cli>` using a new meta-package
689689
for Linux package managers (``apt`` and ``yum``).
690690
- Automatically detects {+mongosh+} when you use the
691-
:ref:`atlas-quickstart` command.
691+
``atlas quickstart`` command.
692692

693693
.. _atlas-cli-1.1.3:
694694

@@ -697,7 +697,7 @@ Released 16 June 2022
697697

698698
Released 13 June 2022
699699

700-
- Improves the :ref:`atlas-quickstart` command:
700+
- Improves the ``atlas quickstart`` command:
701701

702702
- Prompts you to log in if you aren't already logged in.
703703
- Clarifies an error message when no regions are found for a given cloud
@@ -759,7 +759,7 @@ Changes
759759
{+cluster+}.
760760

761761
- Adds :ref:`telemetry <telemetry>` to the {+atlas-cli+}.
762-
- Adds the ``--currentIp`` flag to the :ref:`atlas-quickstart` and
762+
- Adds the ``--currentIp`` flag to the ``atlas quickstart`` and
763763
:ref:`atlas-setup` commands. ``--currentIp`` indicates whether to use
764764
the IP address of the host that is currently executing the command.
765765

@@ -774,14 +774,14 @@ Released 28 April 2022
774774
Changes
775775
~~~~~~~
776776

777-
- Improves :ref:`atlas-quickstart` commands:
777+
- Improves ``atlas quickstart`` commands:
778778

779-
- Clusters created using :ref:`atlas-quickstart` now start
779+
- Clusters created using ``atlas quickstart`` now start
780780
with the cluster prefix and five digits.
781-
- :ref:`atlas-quickstart` now displays a default cluster
781+
- ``atlas quickstart`` now displays a default cluster
782782
option before starting interactive setup.
783783
- {+atlas-cli+} automatically identifies the ``mongosh`` path for
784-
:ref:`atlas-config` and :ref:`atlas-quickstart` commands.
784+
:ref:`atlas-config` and ``atlas quickstart`` commands.
785785

786786
- Makes minor improvements to the {+atlas-cli+} documentation.
787787

‎source/atlas-cli-ephemeral-cluster.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,13 +69,13 @@ Follow These Steps
6969
Alternatively, you can use the :ref:`atlas-projects-list`
7070
command to find the project ID.
7171

72-
d. Run the :ref:`atlas-quickstart` command to create an ``M10``
72+
d. Run the :ref:`atlas-setup` command to create an ``M10``
7373
{+cluster+} and a database user. Replace <YOUR-PASSWORD> with a password for the database user and replace <PROJECT-ID> with
7474
the project ID for the ephemeral project you created.
7575

7676
.. code-block::
7777

78-
atlas quickstart --clusterName myEphemeralCluster --provider AWS --region US_EAST_1 --tier M10 --username myEphemeralUser --password <YOUR-PASSWORD> --currentIp --skipSampleData --projectId <PROJECT-ID> --force
78+
atlas setup --clusterName myEphemeralCluster --provider AWS --region US_EAST_1 --tier M10 --username myEphemeralUser --password <YOUR-PASSWORD> --currentIp --skipSampleData --projectId <PROJECT-ID> --force
7979

8080
After |service| creates the {+cluster+}, the {+atlas-cli+}
8181
provides the :manual:`connection string

‎source/command

Lines changed: 0 additions & 1 deletion
This file was deleted.

‎source/command/atlas-accessLists-create.txt

Lines changed: 140 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,140 @@
1+
.. _atlas-accessLists-create:
2+
3+
========================
4+
atlas accessLists create
5+
========================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 1
13+
:class: singlecol
14+
15+
Create an IP access list entry for your project.
16+
17+
The access list can contain trusted IP addresses, AWS security group IDs, and entries in Classless Inter-Domain Routing (CIDR) notation. You can add only one access list entry at a time. You can create one access list per project.
18+
19+
The command doesn't overwrite existing entries in the access list. Instead, it adds the new entries to the list of entries.
20+
21+
To use this command, you must authenticate with a user account or an API key with the Read Write role.
22+
23+
Syntax
24+
------
25+
26+
.. code-block::
27+
:caption: Command Syntax
28+
29+
atlas accessLists create [entry] [options]
30+
31+
.. Code end marker, please don't delete this comment
32+
33+
Arguments
34+
---------
35+
36+
.. list-table::
37+
:header-rows: 1
38+
:widths: 20 10 10 60
39+
40+
* - Name
41+
- Type
42+
- Required
43+
- Description
44+
* - entry
45+
- string
46+
- false
47+
- IP address, CIDR address, or AWS security group ID that you want to add to the access list.
48+
49+
Options
50+
-------
51+
52+
.. list-table::
53+
:header-rows: 1
54+
:widths: 20 10 10 60
55+
56+
* - Name
57+
- Type
58+
- Required
59+
- Description
60+
* - --comment
61+
- string
62+
- false
63+
- Optional description or comment for the entry.
64+
* - --currentIp
65+
-
66+
- false
67+
- Flag that adds the IP address from the host that is currently executing the command to the access list. Only applicable for type ipAddress entries. You don't need the entry argument when you use the currentIp option.
68+
* - --deleteAfter
69+
- string
70+
- false
71+
- ISO-8601-formatted UTC date after which Atlas removes the entry from the access list.
72+
* - -h, --help
73+
-
74+
- false
75+
- help for create
76+
* - -o, --output
77+
- string
78+
- false
79+
- Output format. Valid values are json, json-path, go-template, or go-template-file. To see the full output, use the -o json option.
80+
* - --projectId
81+
- string
82+
- false
83+
- Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable.
84+
* - --type
85+
- string
86+
- false
87+
- Type of access list entry. Valid values are cidrBlock, ipAddress, or awsSecurityGroup. This value defaults to "ipAddress".
88+
89+
Inherited Options
90+
-----------------
91+
92+
.. list-table::
93+
:header-rows: 1
94+
:widths: 20 10 10 60
95+
96+
* - Name
97+
- Type
98+
- Required
99+
- Description
100+
* - -P, --profile
101+
- string
102+
- false
103+
- Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.
104+
105+
Output
106+
------
107+
108+
If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.
109+
110+
.. code-block::
111+
112+
Created a new IP access list.
113+
114+
115+
Examples
116+
--------
117+
118+
.. code-block::
119+
120+
# Create an IP access list entry using the current IP address:
121+
atlas accessList create --currentIp
122+
123+
124+
.. code-block::
125+
126+
# Create an access list entry for the IP address 192.0.2.15 in the project with ID 5e2211c17a3e5a48f5497de3:
127+
atlas accessList create 192.0.2.15 --type ipAddress --projectId 5e2211c17a3e5a48f5497de3 --comment "IP address for app server 2" --output json
128+
129+
130+
.. code-block::
131+
132+
# Create an access list entry in CIDR notation for 73.231.201.205/24 in the project with ID 5e2211c17a3e5a48f5497de3:
133+
atlas accessList create 73.231.201.205/24 --type cidrBlock --projectId 5e2211c17a3e5a48f5497de3 --output json --comment "CIDR block for servers C - F"
134+
135+
136+
.. code-block::
137+
138+
# Create an access list entry for the AWS security group sg-903004f8 in the project with ID 5e2211c17a3e5a48f5497de3:
139+
atlas accessList create sg-903004f8 --type awsSecurityGroup
140+
--projectId 5e2211c17a3e5a48f5497de3 --output json --comment "AWS Security Group"

‎source/command/atlas-accessLists-delete.txt

Lines changed: 108 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
.. _atlas-accessLists-delete:
2+
3+
========================
4+
atlas accessLists delete
5+
========================
6+
7+
.. default-domain:: mongodb
8+
9+
.. contents:: On this page
10+
:local:
11+
:backlinks: none
12+
:depth: 1
13+
:class: singlecol
14+
15+
Remove the specified IP access list entry from your project.
16+
17+
The command, when run without the force option, prompts you to confirm the operation.
18+
19+
To use this command, you must authenticate with a user account or an API key with the Read Write role.
20+
21+
Syntax
22+
------
23+
24+
.. code-block::
25+
:caption: Command Syntax
26+
27+
atlas accessLists delete <entry> [options]
28+
29+
.. Code end marker, please don't delete this comment
30+
31+
Arguments
32+
---------
33+
34+
.. list-table::
35+
:header-rows: 1
36+
:widths: 20 10 10 60
37+
38+
* - Name
39+
- Type
40+
- Required
41+
- Description
42+
* - entry
43+
- string
44+
- true
45+
- The IP address, CIDR address, or AWS security group ID that you want to remove from the access list.
46+
47+
Options
48+
-------
49+
50+
.. list-table::
51+
:header-rows: 1
52+
:widths: 20 10 10 60
53+
54+
* - Name
55+
- Type
56+
- Required
57+
- Description
58+
* - --force
59+
-
60+
- false
61+
- Flag that indicates whether to skip the confirmation prompt before proceeding with the requested action.
62+
* - -h, --help
63+
-
64+
- false
65+
- help for delete
66+
* - --projectId
67+
- string
68+
- false
69+
- Hexadecimal string that identifies the project to use. This option overrides the settings in the configuration file or environment variable.
70+
71+
Inherited Options
72+
-----------------
73+
74+
.. list-table::
75+
:header-rows: 1
76+
:widths: 20 10 10 60
77+
78+
* - Name
79+
- Type
80+
- Required
81+
- Description
82+
* - -P, --profile
83+
- string
84+
- false
85+
- Name of the profile to use from your configuration file. To learn about profiles for the Atlas CLI, see https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.
86+
87+
Output
88+
------
89+
90+
If the command succeeds, the CLI returns output similar to the following sample. Values in brackets represent your values.
91+
92+
.. code-block::
93+
94+
Project access list entry '<Name>' deleted
95+
96+
97+
Examples
98+
--------
99+
100+
.. code-block::
101+
102+
# Remove the IP address 192.0.2.0 from the access list for the project with the ID 5e2211c17a3e5a48f5497de3 after prompting for a confirmation:
103+
atlas accessLists delete 192.0.2.0 --projectId 5e2211c17a3e5a48f5497de3
104+
105+
.. code-block::
106+
107+
# Remove the IP address 192.0.2.0 from the access list for the project with the ID 5e2211c17a3e5a48f5497de3 without requiring confirmation:
108+
atlas accessLists delete 192.0.2.0 --projectId 5e2211c17a3e5a48f5497de3 --force

0 commit comments

Comments
 (0)